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
 ```