Supervisor Commands
Host-side commands for interacting with running agent sessions. All communication goes through Unix sockets on the shared logs volume — delivery is instant.
cspace send
Section titled “cspace send”Send a message to a running agent or coordinator.
Syntax
Section titled “Syntax”cspace send <instance> "text"cspace send _coordinator "text"Description
Section titled “Description”Injects a user turn into the target’s live conversation via the supervisor socket. The message appears immediately as if the user typed it.
Use _coordinator as the target to reach the coordinator — this is the well-known address that all workers use to report completion. Use an instance name (e.g., mercury, issue-42) to send to a specific agent.
Examples
Section titled “Examples”# Send a directive to an agentcspace send mercury "Focus on the authentication module first"
# Report completion to the coordinator (used by workers in their final step)cspace send _coordinator "Worker issue-42 complete. Status: success. PR: https://github.com/.../pull/99"
# Redirect the coordinatorcspace send _coordinator "Skip issue #15, it's already been resolved"cspace interrupt
Section titled “cspace interrupt”Interrupt a running agent session.
Syntax
Section titled “Syntax”cspace interrupt <instance>Description
Section titled “Description”Sends an interrupt signal to the specified instance’s supervisor. The supervisor exits cleanly, saving state. The workspace is preserved — all files, branches, and uncommitted changes remain intact.
Examples
Section titled “Examples”cspace interrupt mercurycspace interrupt _coordinatorcspace agent-status
Section titled “cspace agent-status”Show supervisor status as JSON.
Syntax
Section titled “Syntax”cspace agent-status <instance>Description
Section titled “Description”Returns raw JSON status from the instance’s supervisor socket, including role, session ID, turn count, and last activity.
Examples
Section titled “Examples”cspace agent-status mercurycspace agent-status mercury | jq .cspace restart-supervisor
Section titled “cspace restart-supervisor”Restart the agent supervisor while preserving the workspace.
Syntax
Section titled “Syntax”cspace restart-supervisor <instance> [--reason "text"]| Flag | Description |
|---|---|
--reason "text" | Explain why the restart is needed (visible to the agent when it resumes) |
Description
Section titled “Description”Restarts an agent’s supervisor inside its existing container:
- Sends an interrupt to the old supervisor via the socket
- Waits up to 30 seconds for the old supervisor to exit (detected by socket disappearing)
- If
--reasonis given, prepends a restart context marker to the prompt - Launches a new supervisor in detached mode with the same prompt file
Preserved: all files, branches, uncommitted changes, the original prompt. Must be re-established by the agent: browser sessions, running servers, external state.
Examples
Section titled “Examples”cspace restart-supervisor mercurycspace restart-supervisor mercury --reason "Agent stuck on a dead Playwright connection"