Watch
0
0
Fork
You've already forked hyperhive
0

document reading and editing an agent's agents.md through the swarm

docs/swarm/README.md gets the routes, the revision, the apply semantics
and the stopped-agent behaviour; the persistence doc points there from
the AGENTS.md entry. The swarm-controller, swarm-controller-api and
swarmctl READMEs and the repo map in AGENTS.md list the new bodies and
routes. docs/tools/swarmctl-cli.md is regenerated for
`swarmctl agent agents-md`, whose help text loses two passive phrasings
vale flags.
This commit is contained in:
atlas 2026-10-18 03:37:27 +02:00 • committed by mara
commit 9add99838c
8 changed files with 124 additions and 13 deletions

View file

@ -7,8 +7,9 @@ that talk to the controller, from anywhere as your own SSO account (see
Distinct from `hivectl`, which drives one hive's `hive-c0re` over its
admin socket. This crate doesn't link `swarm-controller`, for the same
reason `hivectl` doesn't link `hive-c0re`; the forge and schedule bodies
and the agent responses both sides speak come from `swarm-controller-api`,
reason `hivectl` doesn't link `hive-c0re`; the forge, schedule and
`AGENTS.md` bodies and the agent responses both sides speak come from
`swarm-controller-api`,
as `hivectl`'s come from `hive-host-sock`.
## Why root, and why no socket

View file

@ -306,7 +306,7 @@ enum AgentVerb {
/// Show an agent's AGENTS.md, or edit it with a diff.
///
/// `get` shows the copy the agent last published, so it works while the
/// agent is stopped. `apply` hands the diff to the agent, which applies
/// agent isn't running. `apply` hands the diff to the agent, which applies
/// it to the file with `git apply`; it needs the agent running.
AgentsMd {
#[command(subcommand)]
@ -333,7 +333,7 @@ struct AgentsMdApplyArgs {
agent: String,
/// The file holding the diff.
diff_file: PathBuf,
/// The revision the diff was made against, as `get` printed it. It is
/// The revision you made the diff against, as `get` printed it. It's
/// the git blob id of that text, so `git hash-object` of the unedited
/// file prints it too.
#[arg(long, value_name = "REVISION")]