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

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install agent-app
  2. Said no? Turn it on later:
    hermes plugins enable agent-app
  3. 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_describe agent_app_find agent_app_list agent_app_get agent_app_create agent_app_update agent_app_delete agent_app_run_operation agent_app_poll_tasks agent_app_next_task agent_app_task_progress agent_app_complete_task agent_app_build agent_app_validate agent_app_serve agent_app_stop agent_app_open agent_app_list_apps agent_app_catalogue agent_app_inspect agent_app_install agent_app_export
Adds hooks
pre_gateway_dispatch pre_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
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

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

← All plugins