CLI

The toolang command is the main user interface for the runtime.

Analysis commands

toolang check <agent_ref>
toolang dump ast <agent_ref>
toolang dump ir <agent_ref>
toolang dump messages <agent_ref>

These commands inspect or validate an agent without starting long-running execution.

Execution commands

toolang run <agent_ref>
toolang serve <agent_ref>
toolang start <agent_ref>

• run: one-shot foreground execution
• serve: long-running foreground execution
• start: long-running background execution

Capability commands

toolang skill add <cap_ref>
toolang skill remove <cap_ref>
toolang skill list
toolang skill sync
toolang skill update

The same command shape applies to:

• service
• prompt
• psyche

There are also aggregate commands:

toolang caps list
toolang caps sync
toolang caps update

Running-agent commands

toolang ps
toolang inspect <run_ref>
toolang logs <run_ref>
toolang stop <run_ref>

run_ref may be either:

• an agent_ref
• a house_no