Chat commands

Chat commands

Command	Meaning
/agent <sub>	Drives fleet control and configuration.
/ask <agent> <text>	Sends a message to any registered agent on the bus.
/<agent> <text>	Calls that enabled agent directly (or its alias).
@<agent> <text>	Mentions the agent in the message body to route directly to it.
replying to an agent’s relayed message	Delivers straight to that agent — no command needed.
/start login	Generates and sends a single-use web app login link (DM only).
/user add @username	Adds an allowed user to the group/chat (group creator only).
/scope	Binds the current topic to a scope, or lists / adds / removes scopes.
/project	Binds or manages project registration for the current group chat.

/agent subcommands

Subcommand	Arguments	Meaning
status	[name]	Shows process status, bus listener, template drift, and relay health.
up	[name] | --project <project>	Boots all autoboot agents, a specific agent, or the whole fleet in a project.
down	<name> | --all	Stops a specific agent, or stops all agents in current scope.
restart	<name>	Stops it, then boots a fresh session seeded with a summary of the session that died.
rotate	<name>	Stops it, then boots a fresh, completely blank session.
finish	—	Stops all agents in all scopes and stops the web app (the gateway stays up — /agent up still works).
add	<name> <runtime> [model=<m>]	Registers a new agent.
models	[runtime]	Lists available models for installed runtimes.
set	<name> <field> <value>	Updates an agent setting.
prompt	<name> [text | --yes | --cancel]	Inspects, stages, confirms, or cancels the agent’s system prompt.
project	add <name> <absolute-path> | list | rm <name> [--yes]	Registers, lists, or removes a project.
resync	<name> | --all	Resyncs the prompt template from disk.
rm	<name> [--yes]	Deletes the agent from the registry.
web	—	Ensures the web server is running, returns the dashboard link.

set takes exactly 8 fields: model, effort, autoboot, enabled, open_window, hang_threshold_minutes, auto_sleep_enabled, auto_sleep_minutes. Any other field is refused.

Syntax per gateway

Gateway	Syntax
Telegram	Commands start with /
Discord	Commands start with / — native slash commands or typed as plain text both work
Webhook	Commands start with / inside the text field
Slack	Commands start with ! (e.g. !agent status, !start login) — Slack drops unregistered / commands

Where a command works

Command	Limit
/start login	DM only
/user add	Group only, and only the group creator can call it
/project	Group only
/scope (topic binding)	Only inside a forum topic / thread

Messages the machine sends

Sender	To the chat?	Meaning
watchdog-nudge:<agent>:<sender>	no	An internal reminder the agent itself receives.
watchdog-alert:<agent>	yes	Needs you to act — run /agent status.