CLI Commands

Global flags

--registry <path>    Registry file path
                     Default: registry.json
                     Env: SOCIETY_REGISTRY

The --registry flag must appear before the subcommand.

`society onboard`

Interactive wizard to register a new agent.

society onboard

Prompts for: name, description, transport type, transport-specific config, and skills.

`society list`

List all registered agents.

society list

Output columns: NAME, TRANSPORT, ENDPOINT, SKILLS

`society remove <name>`

Remove an agent from the registry. Prompts for confirmation.

society remove my-agent

`society ping <name>`

Health-check an agent by sending a test message.

society ping my-agent

Reports: transport type, agent name, skills, and latency in milliseconds.

`society run`

Start a single agent from a config file.

society run --config <path> [--stdio]

Flag	Description
`--config`	Path to agent YAML config (required)
`--stdio`	Run as stdio agent instead of HTTP server

`society send`

Send a message to a registered agent.

society send [--thread <id>] <name> <message>

Flag	Description
`--thread`	Thread ID to continue a conversation

The --thread flag must come before the agent name. Remaining arguments after the name are joined as the message text.

`society export`

Export the registry as JSON.

society export [--output <path>]

Without --output, prints to stdout.

`society import <path-or-url>`

Import agents from a JSON file or URL.

society import agents-backup.json
society import https://example.com/agents.json

Prompts interactively for conflicts: overwrite, skip, or rename.

`society discover <url>`

Discover an agent from an A2A endpoint.

society discover http://server:8001

Fetches the agent card from /.well-known/agent.json, displays it, and optionally adds it to the registry with a transport config you choose.

`society mcp`

Start an MCP server on stdio.

society mcp

Exposes each registered agent as an MCP tool (send_<name>). See MCP Integration for setup details.

`society daemon`

Manage the agent daemon.

`daemon start [agents...] [--agents <dir>]`

Start agents in the background.

society daemon start                    # all agents in agents/
society daemon start echo claude        # specific agents
society daemon start --agents ~/agents  # custom directory

`daemon stop`

Stop the running daemon (sends SIGTERM, waits up to 5s).

society daemon stop

`daemon status`

Show daemon uptime, PID, and running agents.

society daemon status

`daemon run [agents...] [--agents <dir>]`

Start agents in the foreground (logs to stdout, Ctrl+C to stop).

society daemon run
society daemon run echo greeter