How hermes-hq/hermes-ide works
Hermes IDE is a cross-platform desktop terminal that combines ordinary agent-in-PTY sessions with an optional rendered Claude conversation, project-aware context, command suggestions, and workflow tools. The main path is user → session/workspace UI and state → terminal or agent runtime, with the React frontend calling Rust through Tauri IPC for persistence and project operations. Other documented branches include Git, plugins, fleet sessions, review/land, cost tracking, and notifications. The graph uses README claims and shown source references; unsampled subsystem links are omitted rather than inferred.
Main entry points: App.tsx App shell · SessionContext.tsx Session workspace · lib.rs Rust backend · projects.ts Project API
Components 24
Desktop experience
- App shell
src/App.tsx - Session workspace
src/state/SessionContext.tsx - Session API
src/api/sessions.ts
Agent sessions
- Terminal pool
src/terminal/TerminalPool.ts - Agent conversation store
src/agent/agentSessionStore.ts - Session event store
src/agent/contract/sessionEventStore.ts - Session providers
src/agent/providers/useSessionProviders.ts - Agent status
src/agent/status/deriveStatus.ts
Project intelligence
- Project scanning and context
src-tauri/src/project/mod.rs - Context assembly UI
src/hooks/useContextState.ts - Project API
src/api/projects.ts - Command suggestions
src/terminal/intelligence/suggestionEngine.ts
Workflow tools
- Git integration
src/api/git.ts - Plugin runtime
src/plugins/PluginRuntime.ts - Fleet controls
src/fleet/useFleetControls.ts - Track workflow
src/track/store.ts - Review workflow
src/review/reviewStore.ts - Done-when checks
src/doneWhen/controller.ts - Cost dashboard
src/components/CostDashboard.tsx - Attention center
src/components/AttentionCenter.tsx
Native services
- Rust backend
src-tauri/src/lib.rs - PTY sessions
src-tauri/src/pty/commands.rs - SQLite persistence
src-tauri/src/db/mod.rs
Other components
- User
Connections 23
- User → App shell: uses
README.md - App shell → Session workspace: manages sessions
src/App.tsx - Session workspace → Session API: loads and saves
src/state/SessionContext.tsx - Session workspace → Terminal pool: creates terminals
src/state/SessionContext.tsx - Session workspace → Project API: loads projects
src/state/SessionContext.tsx - Session API → Rust backend: invokes IPC
README.md - Project API → Rust backend: invokes IPC
README.md - Rust backend → PTY sessions: manages PTY
README.md - Rust backend → SQLite persistence: persists data
README.md - Rust backend → Project scanning and context: assembles context
README.md - Context assembly UI → Project API: assembles context
src/hooks/useContextState.ts - Terminal pool → Command suggestions: suggests commands
README.md - Session workspace → Git integration: integrates Git
src/state/SessionContext.tsx - App shell → Plugin runtime: hosts runtime
src/App.tsx - Session providers → Session event store: dispatches events
src/agent/providers/useSessionProviders.ts - Session providers → Agent conversation store: observes sessions
src/agent/providers/useSessionProviders.ts - Agent status → Session event store: derives from events
src/agent/status/deriveStatus.ts - App shell → Fleet controls: offers fleet tools
- App shell → Track workflow: offers tracking
src/App.tsx - App shell → Review workflow: offers review
- App shell → Done-when checks: starts checks
src/App.tsx - App shell → Cost dashboard: opens dashboard
src/App.tsx - App shell → Attention center: hosts inbox
src/App.tsx