Knowledge Base updated: 2026-11-19
Hermes Agent knowledge base
Hermes Agent is a multi-surface AI agent product: a command-line control plane, long-running gateway, browser/desktop/TUI clients, and extensibility systems for tools, plugins, skills, and providers.
The gateway and agent runtime execute work; clients and platform adapters submit, observe, and deliver it. Durable state, sessions, profiles, messages, and coordination records are maintained by the shared persistence layer.
flowchart LR
User[Users and platforms] --> CLI[CLI]
User --> Web[Web dashboard]
User --> Desktop[Desktop application]
User --> TUI[TUI / ACP clients]
CLI --> Gateway[Gateway service]
Web --> Gateway
Desktop --> Gateway
TUI --> Gateway
Gateway --> Runtime[Agent runtime]
Runtime --> Providers[Model providers]
Runtime --> Tools[Tools and guardrails]
Gateway --> State[State and persistence]
Gateway --> Platforms[Platform delivery]
Runtime --> Plugins[Plugin platform]
Runtime --> Skills[Skills system]
Gateway --> Automation[Scheduled automation]
Glossary
- Gateway — the long-running local service that accepts events, owns active sessions, and delivers agent output.
- Profile — a named configuration and identity context used to select runtime settings, integrations, and models.
- Turn — one bounded unit of agent work, from inbound request assembly through final output or failure.
- Skill — reusable packaged instruction and support content that can be bundled or optionally installed for agent use.
- ACP — Agent Client Protocol, the external protocol bridge for compatible agent clients.
Invariants
- Session and message work must use durable shared state rather than client-local authority; see
packages/state/**and docs/state-and-persistence.md. - Gateway clients interact through the generated RPC contract rather than independent ad hoc method definitions; see apps/…/gateway-contract.generated.ts and apps/…/gateway-contract.openrpc.json.
- Agent execution routes tool use through approval, validation, and recovery controls; see
packages/**/tools/**and docs/agent-tools-and-guardrails.md. - Plugin and skill extensions are discovered and validated before being exposed to runtime or product surfaces; see
packages/plugins/**,skills/**, and their lifecycle pages. - Desktop packaging keeps the Electron shell and its provisioned payload aligned across build and relaunch paths; see
apps/desktop/scripts/**andapps/desktop/electron/**.
Routing table
packages/**/agent/**-> Agent runtimepackages/**/agent/**/turn/**-> Agent turn executionpackages/**/providers/**-> Model provider integrationpackages/**/context/**-> Context, memory, and compressionpackages/**/tools/**-> Agent tools and guardrailsapps/gateway/**-> Gateway serviceapps/gateway/**/inbound/**-> Gateway inbound and turn routingapps/gateway/**/session/**-> Gateway session lifecycle and recoveryapps/gateway/**/platform/**-> Gateway platform delivery and streamingapps/cli/**-> Command-line productapps/cli/**/setup/**-> CLI setup and configurationapps/cli/**/commands/**-> CLI sessions and platform operationsapps/cli/**/update/**-> Installation, update, and recoveryapps/shared/src/gateway-contract.*-> User interfaces and local APIapps/web/**-> Web dashboardapps/tui/**-> TUI gateway RPCapps/desktop/**-> Desktop applicationpackages/state/**-> State and persistencepackages/state/**/schema/**-> State storage integritypackages/state/**/session/**-> Session data managementpackages/**/cron/**-> Scheduled automationpackages/**/cron/**/jobs/**-> Scheduled job executionpackages/plugins/**-> Plugin platformpackages/plugins/**/lifecycle/**-> Plugin lifecycle and integrationpackages/plugins/**/catalog/**-> Plugin catalog and discoverypackages/**/acp/**-> Agent client protocolpackages/**/acp/**/gateway/**-> ACP gateway bridgepackages/**/delegation/**-> Delegated agent workflowspackages/**/delegation/**/routing/**-> Delegation routing and executionpackages/**/hosted-rooms/**-> Hosted agent roomspackages/**/hosted-rooms/**/work/**-> Hosted room coordination and work executionpackages/**/package-management/**-> Package management and distributionpackages/**/package-management/**/environment/**-> Package resolution and environment buildspackages/**/kanban/**-> Kanban workflow automationpackages/**/kanban/**/workers/**-> Kanban workflow executionskills/**-> Skills system- skills/…/SKILL.md -> Skill discovery and lifecycle