# Agent Apps: Hermes Agent plugin

> 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).

Canonical: https://hermeswatcher.com/plugins/agent-app  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/agent-app  
Last updated in catalog: 2026-11-19

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 the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install agent-app
```

2. Said no? Turn it on later:

```bash
hermes plugins enable agent-app
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- 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`
- Requires Hermes: `>=0.21.6`
- Version: 0.1.1
- In the catalog since: 2026-11-10, updated 2026-11-19

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/agent-app)
- [Source code](https://github.com/CraftOS-dev/Agent-App/tree/main/harness-plugins/hermes#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
