Status Command

Display automaton status and activity

The status command shows the current state of your automaton, including configuration, execution statistics, and recent activity.

Runtime CLI

automaton --status

Shows detailed status from the runtime perspective:

Example Output

=== AUTOMATON STATUS ===
Name:       my-agent
Address:    0x1234567890abcdef1234567890abcdef12345678
Creator:    0x742d35Cc6634C0532925a3b844Bc454e4438f44e
Sandbox:    sandbox-abc123
State:      running
Turns:      42
Tools:      8 installed
Skills:     3 active
Heartbeats: 2 active
Children:   1 alive / 1 total
Agent ID:   agent-xyz789
Model:      gpt-5-mini
Version:    0.2.1
========================

Creator CLI

automaton-cli status

Shows status from the creator’s perspective with recent activity:

Example Output

=== my-agent ===
Address:    0x1234567890abcdef1234567890abcdef12345678
Creator:    0x742d35Cc6634C0532925a3b844Bc454e4438f44e
Sandbox:    sandbox-abc123
State:      running
Turns:      42
Tools:      8 installed
Heartbeats: 2 active
Model:      gpt-5-mini

Recent activity:
  [2026-03-03T10:30:00.000Z] Checking social messages and responding to any new messages from my cr... (tools: social_check_messages, social_send_message)
  [2026-03-03T10:15:00.000Z] Analyzing treasury balance and deciding whether to top up credits bas... (tools: get_balance, topup_credits)
  [2026-03-03T10:00:00.000Z] Reading configuration to understand current model strategy and infer... (tools: read_config)

Status Fields

Identity

Name · string

The automaton’s display name

Address · address

The automaton’s Ethereum address (wallet)

Creator · address

The creator’s Ethereum address

Sandbox · string

Conway sandbox identifier

Execution State

State · enum

Current agent state:

• running - Actively executing
• sleeping - Waiting for next wake time
• dead - Out of credits

Turns · number

Total number of agent turns executed

Agent ID · string

Unique agent identifier (“not registered” if registration failed)

Capabilities

Tools · number

Number of installed tools available to the agent

Skills · number

Number of active skill modules loaded

Heartbeats · number

Number of enabled heartbeat tasks

Children · string

Child automaton statistics (alive count / total count)

Configuration

Model · string

Active inference model (e.g. “gpt-5-mini”, “gpt-oss:120b”)

Version · string

Conway Automaton runtime version

Recent Activity (Creator CLI Only)

The creator CLI includes recent turn summaries showing:

• Timestamp - When the turn executed
• Thinking - First 80 characters of the agent’s reasoning
• Tools - Comma-separated list of tools used

This provides a quick view of what your automaton has been doing without diving into full logs.

Use Cases

Quick Health Check

Verify your automaton is running:

automaton --status | grep State

Monitor Progress

Track turn count over time:

watch -n 10 'automaton --status | grep Turns'

Debug Configuration

Verify model and version:

automaton --status | grep -E '(Model|Version)'

Error Cases

Not Configured

$ automaton --status
Automaton is not configured. Run the setup script first.

Solution: Run automaton --setup to configure your automaton.

No Configuration Found (Creator CLI)

$ automaton-cli status
No automaton configuration found.

Solution: Run automaton --init and automaton --setup from the runtime CLI first.

Related Commands

Logs

View detailed execution logs

Run

Start the automaton