Agent Apps
From its catalog listing
Build, evolve and operate Agent Apps from Hermes: full applications that you use in the browser and the agent uses through their own CLI (a CRM, a dashboard, an expense tracker). Adds the /agent-app command, `hermes agent-app`, the six framework skills, 22 agent_app_* tools to build, validate, launch, operate, install and export apps, and an Agent Apps tab in `hermes dashboard` and hermes-webui: one tab per app with its own Hermes session, a marketplace, an import panel, and Connect for an app that runs on another machine.
Good to know before installing
needs the agent-app-framework npm CLIs and runs `agent-app` / `a2app` as subprocesses (never through a shell), including `agent-app skills --path` each time the plugin loads and `agent-app --version` on the first tool call, with only the environment the framework needs, so provider keys reach neither the CLIs nor the apps they serve; the skills are the ones that CLI ships, not a copy in the pinned tree. Installing, building or serving an app runs that app's toolkit commands (dependency install, build, server) on this machine. A pre_tool_call hook sends installs and inspects from any source but the default marketplace, operations the app holds for approval, and writes or app runs outside ~/.a2app/apps and the working directory to Hermes's approval prompt (refused by default where nobody can answer). The tab runs each app turn as a `hermes --cli chat -Q` child under your own model and approval policy (dangerous commands follow approvals.single_query_mode, default deny; the host's /yolo, session and gateway state are not inherited). Apps it builds, installs or launches keep serving on loopback ports until paused. Writes apps under ~/.a2app/apps and, on load, a `hermes` entry in ~/.a2app/harnesses.json (only when none exists) so a bridge you start yourself can run Hermes turns when an app queues work; reads and deletes its own app sessions in Hermes's session database. The Marketplace reads its catalogue from GitHub (CraftOS-dev/agent-app-collection), Import downloads the zip or git URL you give, and Connect calls the app address you enter and stores that app's credential in ~/.a2app/credentials.json. In hermes-webui a token-protected loopback backend serves the tab. No telemetry.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install agent-app - Said no? Turn it on later:
hermes plugins enable agent-app - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Web, research & browsing · Work & business
- Maintained by
- CraftOS (Community)
- Needs
- No API keys declared
- Adds tools
agent_app_describeagent_app_findagent_app_listagent_app_getagent_app_createagent_app_updateagent_app_deleteagent_app_run_operationagent_app_poll_tasksagent_app_next_taskagent_app_task_progressagent_app_complete_taskagent_app_buildagent_app_validateagent_app_serveagent_app_stopagent_app_openagent_app_list_appsagent_app_catalogueagent_app_inspectagent_app_installagent_app_export- Adds hooks
pre_gateway_dispatchpre_tool_call- Needs Hermes
- 0.21.6 or newer
- Version
- 0.1.1
- In the catalog
- 2026-11-10, updated 2026-11-19
- GitHub stars
- 9
Known issues (from its catalog listing)
- Needs the framework CLIs on PATH first: npm i -g agent-app-framework@0.2.0, the release this was tested with (Node 20 or later).
- The hermes-webui tab is a web UI extension that a catalog install does not place; from a clone, run python harness-plugins/hermes/scripts/build.py --install --webui. Hermes Desktop loads no dashboard plugins, so the tab is not there; the tools, skills and command are.
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in web, research & browsing
All web, research & browsing plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher