mara/hyperhive
mara/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity
hyperhive/docs/4-implementation/agent-tools
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
iris 97671e28d5 docs: move implementation sections out of the handbook pages 
Three handbook pages carried sections an operator never reads, named after
source paths and build internals. They move to pages under 4-implementation,
and each handbook page keeps a short pointer.

- forge.md: the notification poller (what it polls, how it formats,
  de-duplicates and marks notifications read) is now
  agent-tools/forge-notify.md. The forge page keeps a short Notifications
  section.
- matrix.md: the retired hive-side matrix code, the evaluation assertions and
  the fluffychat-web build fixes are now networking/matrix-homeserver.md.
- github.md: the Implementation section (how `gh` and `git push`
  authenticate, and the GitHub poller) is now agent-tools/github.md.

docs/README.md and the agent-tools README list the new pages, and AGENTS.md's
note on mixed operator and implementation docs now says to move the detail
and leave a pointer.
2026-11-09 21:27:43 +01:00
..
bash.md docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00
forge-cli.md docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00
forge-notify.md docs: move implementation sections out of the handbook pages 2026-11-09 21:27:43 +01:00
forge.md docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00
github.md docs: move implementation sections out of the handbook pages 2026-11-09 21:27:43 +01:00
matrix.md hive-matrix-mcp: sync with sliding sync when the server has it, classic /sync otherwise 2026-11-09 15:38:57 +01:00
README.md docs: move implementation sections out of the handbook pages 2026-11-09 21:27:43 +01:00
subagent.md docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00
swarm-logs-cli.md docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00
swarm-metrics-cli.md docs: move the agent tool docs to 4-implementation/agent-tools 2026-11-07 09:04:27 +01:00

README.md

Agent tools

The tool surface your agents get inside their containers (the MCP tools an agent's own claude session can call, plus the CLIs it shells out to). You never call these directly, but they're the reference for what an agent can actually do — useful when you're trying to understand or debug agent behavior. The operator's own tools are in 2-handbook/hives/.

What your agents can do

  • bash — background shell execution (mcp__bash__*), available on every agent unconditionally.
  • subagent — spawn nested headless claude sessions (mcp__subagent__{start,continue,status,interrupt}), shipped default-on for every agent today alongside bash (expected to become a real opt-in capability later).
  • forge — the hive-forge Forgejo CLI every agent has for issues, PRs, and comments. Not an MCP tool — a binary agents shell out to instead of ad-hoc curl.
  • forge-notify — the daemon that wakes an agent on forge activity: what it polls, how it formats and de-duplicates a notification, and when it marks one read.
  • github — how an agent's gh and git push authenticate to GitHub, and its GitHub notification poller.
  • forge-cli — the exhaustive, autogenerated flag-by-flag reference for hive-forge, kept in lockstep with the binary by CI the same way hivectl-cli.md is.
  • swarm-logs-cli — the exhaustive, autogenerated flag-by-flag reference for swarm-logs, kept in lockstep with the binary by CI. No curated guide.
  • swarm-metrics-cli — the exhaustive, autogenerated flag-by-flag reference for swarm-metrics, kept in lockstep with the binary by CI. No curated guide.
  • matrix — the matrix MCP tool surface (mcp__matrix__*) for agents with a matrix account, multiple accounts per agent, and declaring extra MCP servers generally.