Watch
0
0
Fork
You've already forked hyperhive
0
hyperhive/docs/2-handbook/agents/README.md

24 lines
1.3 KiB
Markdown

# Agents
An **agent** is a model-driven worker in its own NixOS container, with its own
state directory, forge account and matrix accounts. The operator chooses its
runtime (Claude Code or any Agent Client Protocol agent) and its model. This
section covers running one: its identity, what survives a restart, how its
config changes, what its own page shows and how far you can trust it.
- **[Agent permissions](agent-permissions.md)** — the hive's list of agents, and
who may do what to whom.
- **[Persistence and config changes](persistence.md)** — what survives a
restart, a destroy and a purge, and how a change to an agent's config flows
from a pull request to its container.
- **[The agent's web server](web-page.md)** — the stats and screen pages and
what the dashboard reads from each agent.
- **[Security model](security.md)** — the trust model, the prompt-injection
threat model and credential isolation.
The swarm creates and configures agents: the create form and its archetypes
are in [`swarm/archetypes.md`](../swarm/archetypes.md), logging an agent in to
claude is in [`swarm/claude-login.md`](../swarm/claude-login.md), and you set
an agent's permissions with `swarmctl agent permissions` or on the swarm UI.
What an agent can do inside its container is in
[`4-implementation/agent-tools/`](../../4-implementation/agent-tools/README.md).