From ea407823c124c1c32e7b17ef7c9ffd578b6db755 Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Mon, 9 Nov 2026 20:54:46 +0100
Subject: [PATCH] docs: finish the neutral agent names in the hivectl source
 and the swarmctl README

hivectl-cli.md is generated from the clap doc comment, so the example name
moves into cli.rs; the swarmctl README's create and schedule examples use
agent1/agent2 like the handbook pages.
---
 hivectl/src/cli.rs |  2 +-
 swarmctl/README.md | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/hivectl/src/cli.rs b/hivectl/src/cli.rs
index 867820ba0..9133b94be 100644
--- a/hivectl/src/cli.rs
+++ b/hivectl/src/cli.rs
@@ -35,7 +35,7 @@ pub enum Cmd {
     /// hive-wide lives at the top level instead (`list-agents`,
     /// `restart`/`stop`/`start` with a scope, `quota-enable`).
     Agent {
-        /// Agent name (for example `damocles`, `iris`).
+        /// Agent name (for example `agent1`).
         name: String,
         #[command(subcommand)]
         cmd: AgentCmd,
diff --git a/swarmctl/README.md b/swarmctl/README.md
index 9648f178e..1c9cc129d 100644
--- a/swarmctl/README.md
+++ b/swarmctl/README.md
@@ -104,9 +104,9 @@ generates a new one the same way.
 ## `agent create`
 
 ```console
-# swarmctl agent create scribe --hive alpha
+# swarmctl agent create agent2 --hive alpha
 queued: job node 42
-agent "scribe" will be deployed to hive "alpha" once the job graph runs; `swarmctl` does not wait for it
+agent "agent2" will be deployed to hive "alpha" once the job graph runs; `swarmctl` does not wait for it
 ```
 
 `POST /api/agents` on the swarm-controller, over its unix socket
@@ -194,9 +194,9 @@ refused. The response body comes from `swarm-controller-api`, imported in
 ## `schedule`
 
 ```console
-# swarmctl schedule add --name standup --agent scribe --body "post the standup summary" --every 1d
-# swarmctl schedule list --agent scribe
-# swarmctl schedule edit kqzpmwab --at 2026-10-05T09:00:00+02:00 --add-agent iris
+# swarmctl schedule add --name standup --agent agent2 --body "post the standup summary" --every 1d
+# swarmctl schedule list --agent agent2
+# swarmctl schedule edit kqzpmwab --at 2026-10-05T09:00:00+02:00 --add-agent agent1
 # swarmctl schedule pause kqzpmwab
 # swarmctl schedule rm kqzpmwab
 ```