toolang

Run and manage Toolang agents.
 
Usage: toolang [OPTIONS] <COMMAND> [ARGUMENTS]
 
Agent Commands:
  new        Create an agent
  clone      Clone an agent
  remove     Remove an agent
  list       Show agents and their status
  info       Show agent info
  run        Run an agent in the foreground
  start      Start an agent
  stop       Stop an agent
 
Cap Commands:
  psyche     Manage psyche caps
  skill      Manage skill caps
  service    Manage service caps
  prompt     Manage prompt caps
 
Work Commands:
  chore      Manage agent chores
  task       Manage agent tasks
  workspace  Manage agent workspaces
 
Control Commands:
  chat       Start an interactive TUI
  steer      Steer an active run
  cancel     Cancel an active run
  retry      Retry a run from a failed step
  rerun      Rerun an earlier run as a new one
  fork       Fork a thread from an earlier run
  rewind     Rewind a thread to an earlier run
  compact    Compact a thread
 
Inspection Commands:
  caps       List available caps
  tools      List available tools
  models     List available models
  providers  List available model providers
  catalogs   List installed model catalogs
  adapters   List installed model adapters
  toolsets   List installed toolsets
  sandboxes  List installed sandboxes
  inspect    Inspect agent run history
 
Options:
  -r, --root <PATH>  Use a custom Toolang root
  -V, --version      Show current version and exit
  -h, --help         Show this message and exit

Create an agent.
 
Usage: toolang new [OPTIONS] <AGENT>
 
Arguments:
  * AGENT  New local agent name
 
Options:
  -t, --template <NAME>  Template name  [default: default]
  -h, --help             Show this message and exit

Clone an agent.
 
Usage: toolang clone [OPTIONS] <SOURCE> [TARGET]
 
Arguments:
  * SOURCE  Agent name, reference, or URL
    TARGET  New local agent name
 
Options:
  -h, --help  Show this message and exit

Remove an agent.
 
Usage: toolang remove [OPTIONS] <AGENT>
 
Arguments:
  * AGENT  Local agent name
 
Options:
  -h, --help  Show this message and exit

Show agents and their status.
 
Usage: toolang list [OPTIONS]
 
Options:
  -h, --help  Show this message and exit

Show agent info.
 
Usage: toolang <AGENT> info [OPTIONS]
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
 
Options:
      --catalog <PATH>  Use a specified model catalog
  -h, --help            Show this message and exit

Run an agent in the foreground.
 
Usage: toolang run [OPTIONS] <AGENT>
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
 
Options:
      --sandbox <SANDBOX_SPEC>      Run in this sandbox; defaults to agent
                                    config or host
      --allow <RESOURCE>=<QUERY>    Set RESOURCE=QUERY. Repeat by resource
                                    category
      --limit <LIMIT>=<VALUE>       Set a run limit, e.g. tokens=10000. Repeat
                                    for another limit
      --default <SETTING>=<VALUE>   Set a default model or runnable. Repeat for
                                    another setting
      --compact-model <MODEL_SPEC>  Set an exact model (optional effort=LEVEL),
                                    or unset, for a new runtime
      --catalog <PATH>              Use a specified model catalog
      --host <HOST>                 Bind the agent API to this host  [default:
                                    127.0.0.1]
      --port <PORT>                 Bind the agent API to this port
      --dev [PATH]                  Use a local Toolang wheel  [bare: .]
  -h, --help                        Show this message and exit

Start an agent.
 
Usage: toolang <AGENT> start [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
      --sandbox <SANDBOX_SPEC>      Run in this sandbox; defaults to agent
                                    config or host
      --allow <RESOURCE>=<QUERY>    Set RESOURCE=QUERY. Repeat by resource
                                    category
      --limit <LIMIT>=<VALUE>       Set a run limit, e.g. tokens=10000. Repeat
                                    for another limit
      --default <SETTING>=<VALUE>   Set a default model or runnable. Repeat for
                                    another setting
      --compact-model <MODEL_SPEC>  Set an exact model (optional effort=LEVEL),
                                    or unset, for a new runtime
      --catalog <PATH>              Use a specified model catalog
      --host <HOST>                 Bind the agent API to this host  [default:
                                    127.0.0.1]
      --port <PORT>                 Bind the agent API to this port
      --dev [PATH]                  Use a local Toolang wheel  [bare: .]
  -h, --help                        Show this message and exit

Stop an agent.
 
Usage: toolang <AGENT> stop [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
      --force / --no-force  Force-stop when graceful shutdown does not complete
                            [default: no-force]
  -h, --help                Show this message and exit

Manage psyche caps.
 
Usage: toolang [AGENT] psyche [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  AGENT  Local agent name; omit for root scope
 
Commands:
  list      List psyches
  new       Create a file-backed psyche
  edit      Edit a file-backed psyche
  delete    Delete a file-backed psyche
  add       Wire a psyche ref
  remove    Unwire a psyche
  template  Inspect psyche templates
 
Options:
  -h, --help  Show this message and exit

List psyches.
 
Usage: toolang [AGENT] psyche list [OPTIONS]
 
Arguments:
  AGENT  Local agent name; omit for root psyches only
 
Options:
  -q, --query <QUERY>  Query psyches. Repeat to add matches; see 'too query
                       psyches'
  -h, --help           Show this message and exit

Create a file-backed psyche.
 
Usage: toolang [AGENT] psyche new [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home psyches; omit for root psyches
  * NAME   Psyche name
 
Options:
  -t, --template <NAME>  Template name  [default: default]
  -h, --help             Show this message and exit

Edit a file-backed psyche.
 
Usage: toolang [AGENT] psyche edit [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home psyches; omit for root psyches
  * NAME   Psyche name
 
Options:
  -h, --help  Show this message and exit

Delete a file-backed psyche.
 
Usage: toolang [AGENT] psyche delete [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home psyches; omit for root psyches
  * NAME   Psyche name
 
Options:
  -h, --help  Show this message and exit

Wire a psyche ref.
 
Usage: toolang [AGENT] psyche add [OPTIONS] <REF>
 
Arguments:
    AGENT  Modify the agent's home psyches; omit for root psyches
  * REF    Psyche ref
 
Options:
  -h, --help  Show this message and exit

Unwire a psyche.
 
Usage: toolang [AGENT] psyche remove [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home psyches; omit for root psyches
  * NAME   Psyche name
 
Options:
  -h, --help  Show this message and exit

Inspect psyche templates.
 
Usage: toolang psyche template [OPTIONS] [NAME]
 
Arguments:
  NAME  Template name
 
Options:
  -h, --help  Show this message and exit

Manage skill caps.
 
Usage: toolang [AGENT] skill [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  AGENT  Local agent name; omit for root scope
 
Commands:
  list      List skills
  new       Create a file-backed skill
  edit      Edit a file-backed skill
  delete    Delete a file-backed skill
  add       Wire a skill ref
  remove    Unwire a skill
  template  Inspect skill templates
 
Options:
  -h, --help  Show this message and exit

List skills.
 
Usage: toolang [AGENT] skill list [OPTIONS]
 
Arguments:
  AGENT  Local agent name; omit for root skills only
 
Options:
  -q, --query <QUERY>  Query skills. Repeat to add matches; see 'too query
                       skills'
  -h, --help           Show this message and exit

Create a file-backed skill.
 
Usage: toolang [AGENT] skill new [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home skills; omit for root skills
  * NAME   Skill name
 
Options:
  -t, --template <NAME>  Template name  [default: default]
  -h, --help             Show this message and exit

Edit a file-backed skill.
 
Usage: toolang [AGENT] skill edit [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home skills; omit for root skills
  * NAME   Skill name
 
Options:
  -h, --help  Show this message and exit

Delete a file-backed skill.
 
Usage: toolang [AGENT] skill delete [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home skills; omit for root skills
  * NAME   Skill name
 
Options:
  -h, --help  Show this message and exit

Wire a skill ref.
 
Usage: toolang [AGENT] skill add [OPTIONS] <REF>
 
Arguments:
    AGENT  Modify the agent's home skills; omit for root skills
  * REF    Skill ref
 
Options:
  -h, --help  Show this message and exit

Unwire a skill.
 
Usage: toolang [AGENT] skill remove [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home skills; omit for root skills
  * NAME   Skill name
 
Options:
  -h, --help  Show this message and exit

Inspect skill templates.
 
Usage: toolang skill template [OPTIONS] [NAME]
 
Arguments:
  NAME  Template name
 
Options:
  -h, --help  Show this message and exit

Manage service caps.
 
Usage: toolang [AGENT] service [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  AGENT  Local agent name; omit for root scope
 
Commands:
  list      List services
  new       Create a file-backed service
  edit      Edit a file-backed service
  delete    Delete a file-backed service
  add       Wire a service ref
  remove    Unwire a service
  template  Inspect service templates
 
Options:
  -h, --help  Show this message and exit

List services.
 
Usage: toolang [AGENT] service list [OPTIONS]
 
Arguments:
  AGENT  Local agent name; omit for root services only
 
Options:
  -q, --query <QUERY>  Query services. Repeat to add matches; see 'too query
                       services'
  -h, --help           Show this message and exit

Create a file-backed service.
 
Usage: toolang [AGENT] service new [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home services; omit for root services
  * NAME   Service name
 
Options:
  -t, --template <NAME>  Template name  [default: default]
  -h, --help             Show this message and exit

Edit a file-backed service.
 
Usage: toolang [AGENT] service edit [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home services; omit for root services
  * NAME   Service name
 
Options:
  -h, --help  Show this message and exit

Delete a file-backed service.
 
Usage: toolang [AGENT] service delete [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home services; omit for root services
  * NAME   Service name
 
Options:
  -h, --help  Show this message and exit

Wire a service ref.
 
Usage: toolang [AGENT] service add [OPTIONS] <REF>
 
Arguments:
    AGENT  Modify the agent's home services; omit for root services
  * REF    Service ref
 
Options:
  -h, --help  Show this message and exit

Unwire a service.
 
Usage: toolang [AGENT] service remove [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home services; omit for root services
  * NAME   Service name
 
Options:
  -h, --help  Show this message and exit

Inspect service templates.
 
Usage: toolang service template [OPTIONS] [NAME]
 
Arguments:
  NAME  Template name
 
Options:
  -h, --help  Show this message and exit

Manage prompt caps.
 
Usage: toolang [AGENT] prompt [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  AGENT  Local agent name; omit for root scope
 
Commands:
  list      List prompts
  new       Create a file-backed prompt
  edit      Edit a file-backed prompt
  delete    Delete a file-backed prompt
  add       Wire a prompt ref
  remove    Unwire a prompt
  template  Inspect prompt templates
 
Options:
  -h, --help  Show this message and exit

List prompts.
 
Usage: toolang [AGENT] prompt list [OPTIONS]
 
Arguments:
  AGENT  Local agent name; omit for root prompts only
 
Options:
  -q, --query <QUERY>  Query prompts. Repeat to add matches; see 'too query
                       prompts'
  -h, --help           Show this message and exit

Create a file-backed prompt.
 
Usage: toolang [AGENT] prompt new [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home prompts; omit for root prompts
  * NAME   Prompt name
 
Options:
  -t, --template <NAME>  Template name  [default: default]
  -h, --help             Show this message and exit

Edit a file-backed prompt.
 
Usage: toolang [AGENT] prompt edit [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home prompts; omit for root prompts
  * NAME   Prompt name
 
Options:
  -h, --help  Show this message and exit

Delete a file-backed prompt.
 
Usage: toolang [AGENT] prompt delete [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home prompts; omit for root prompts
  * NAME   Prompt name
 
Options:
  -h, --help  Show this message and exit

Wire a prompt ref.
 
Usage: toolang [AGENT] prompt add [OPTIONS] <REF>
 
Arguments:
    AGENT  Modify the agent's home prompts; omit for root prompts
  * REF    Prompt ref
 
Options:
  -h, --help  Show this message and exit

Unwire a prompt.
 
Usage: toolang [AGENT] prompt remove [OPTIONS] <NAME>
 
Arguments:
    AGENT  Modify the agent's home prompts; omit for root prompts
  * NAME   Prompt name
 
Options:
  -h, --help  Show this message and exit

Inspect prompt templates.
 
Usage: toolang prompt template [OPTIONS] [NAME]
 
Arguments:
  NAME  Template name
 
Options:
  -h, --help  Show this message and exit

Manage agent chores.
 
Usage: toolang <AGENT> chore [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  * AGENT  Local agent name
 
Commands:
  list     List chores
  new      Create a chore
  clone    Clone a chore
  edit     Edit a chore
  delete   Delete a chore
  draft    Move a chore to drafts
  ready    Move a chore to ready
  archive  Move a chore to archive
  cancel   Cancel a chore
  run      Trigger a chore run now
 
Options:
  -h, --help  Show this message and exit

List chores.
 
Usage: toolang <AGENT> chore list [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
      --drafts    List draft items
      --archived  List archived items
      --all       List ready, draft, and archived items
  -h, --help      Show this message and exit

Create a chore.
 
Usage: toolang <AGENT> chore new [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
      --draft  Create the item in drafts
  -h, --help   Show this message and exit

Clone a chore.
 
Usage: toolang <AGENT> chore clone [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Edit a chore.
 
Usage: toolang <AGENT> chore edit [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Delete a chore.
 
Usage: toolang <AGENT> chore delete [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Move a chore to drafts.
 
Usage: toolang <AGENT> chore draft [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Move a chore to ready.
 
Usage: toolang <AGENT> chore ready [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Move a chore to archive.
 
Usage: toolang <AGENT> chore archive [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Cancel a chore.
 
Usage: toolang <AGENT> chore cancel [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Trigger a chore run now.
 
Usage: toolang <AGENT> chore run [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Chore id
 
Options:
  -h, --help  Show this message and exit

Manage agent tasks.
 
Usage: toolang <AGENT> task [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  * AGENT  Local agent name
 
Commands:
  list     List tasks
  new      Create a task
  clone    Clone a task
  edit     Edit a task
  delete   Delete a task
  draft    Move a task to drafts
  ready    Move a task to ready
  archive  Move a task to archive
  cancel   Cancel a task
  reopen   Reopen a task
 
Options:
  -h, --help  Show this message and exit

List tasks.
 
Usage: toolang <AGENT> task list [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
      --drafts    List draft items
      --archived  List archived items
      --all       List ready, draft, and archived items
  -h, --help      Show this message and exit

Create a task.
 
Usage: toolang <AGENT> task new [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
      --draft  Create the item in drafts
  -h, --help   Show this message and exit

Clone a task.
 
Usage: toolang <AGENT> task clone [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Edit a task.
 
Usage: toolang <AGENT> task edit [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Delete a task.
 
Usage: toolang <AGENT> task delete [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Move a task to drafts.
 
Usage: toolang <AGENT> task draft [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Move a task to ready.
 
Usage: toolang <AGENT> task ready [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Move a task to archive.
 
Usage: toolang <AGENT> task archive [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Cancel a task.
 
Usage: toolang <AGENT> task cancel [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Reopen a task.
 
Usage: toolang <AGENT> task reopen [OPTIONS] <ID>
 
Arguments:
  * AGENT  Local agent name
  * ID     Task id
 
Options:
  -h, --help  Show this message and exit

Manage agent workspaces.
 
Usage: toolang <AGENT> workspace [OPTIONS] <COMMAND> [ARGUMENTS]
 
Arguments:
  * AGENT  Local agent name
 
Commands:
  list    List workspaces
  add     Add a workspace
  remove  Remove a workspace
 
Options:
  -h, --help  Show this message and exit

List workspaces.
 
Usage: toolang <AGENT> workspace list [OPTIONS]
 
Arguments:
  * AGENT  Local agent name
 
Options:
  -h, --help  Show this message and exit

Add a workspace.
 
Usage: toolang <AGENT> workspace add [OPTIONS] <PATH>
 
Arguments:
  * AGENT  Local agent name
  * PATH   Existing directory path
 
Options:
      --name <NAME>  Workspace name, normalized to kebab case
  -h, --help         Show this message and exit

Remove a workspace.
 
Usage: toolang <AGENT> workspace remove [OPTIONS] <NAME>
 
Arguments:
  * AGENT  Local agent name
  * NAME   Workspace name
 
Options:
  -h, --help  Show this message and exit

Start an interactive TUI.
 
Usage: toolang <AGENT> chat [OPTIONS]
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
 
Options:
  -t, --thread [THREAD]             Continue a thread instead of a new one
                                    [bare: latest thread]
      --catalog <PATH>              Use a specified model catalog
      --sandbox <SANDBOX_SPEC>      Execute the session in this sandbox
      --allow <RESOURCE>=<QUERY>    Set RESOURCE=QUERY. Repeat by resource
                                    category
      --limit <LIMIT>=<VALUE>       Set a run limit, e.g. tokens=10000. Repeat
                                    for another limit
      --default <SETTING>=<VALUE>   Set a default model or runnable. Repeat for
                                    another setting
      --compact-model <MODEL_SPEC>  Set an exact model (optional effort=LEVEL),
                                    or unset, for a new runtime
      --dev [PATH]                  Use a local Toolang wheel  [bare: .]
  -h, --help                        Show this message and exit

Steer an active run.
 
Usage: toolang <AGENT> steer [OPTIONS] <RUN> <MESSAGE>
 
Arguments:
  * AGENT    Agent name, .too file, reference, or URL
  * RUN      Run id to steer. Thread id means its active run
  * MESSAGE  Instruction to steer the run
 
Options:
  -h, --help  Show this message and exit

Cancel an active run.
 
Usage: toolang <AGENT> cancel [OPTIONS] <RUN>
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
  * RUN    Run id to cancel. Thread id means its active run
 
Options:
  -h, --help  Show this message and exit

Retry a run from a failed step.
 
Usage: toolang <AGENT> retry [OPTIONS] <RUN>
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
  * RUN    Run id to retry. Thread id means its latest visible root run
 
Options:
      --catalog <PATH>            Use a specified model catalog
      --anchor <STEP_PATH>        Retry from this canonical or run-local step
                                  path
      --allow <RESOURCE>=<QUERY>  Set RESOURCE=QUERY. Repeat by resource
                                  category
      --limit <LIMIT>=<VALUE>     Set a run limit, e.g. tokens=10000. Repeat for
                                  another limit
      --dev [PATH]                Use a local Toolang wheel  [bare: .]
  -h, --help                      Show this message and exit

Rerun an earlier run as a new one.
 
Usage: toolang <AGENT> rerun [OPTIONS] <RUN>
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
  * RUN    Run id to rerun. Thread id means its latest visible root run
 
Options:
      --catalog <PATH>            Use a specified model catalog
      --sandbox <SANDBOX_SPEC>    Execute the new run in this sandbox
      --allow <RESOURCE>=<QUERY>  Set RESOURCE=QUERY. Repeat by resource
                                  category
      --limit <LIMIT>=<VALUE>     Set a run limit, e.g. tokens=10000. Repeat for
                                  another limit
      --model <MODEL_SPEC>        Replace the persisted model identity or
                                  parameters
      --dev [PATH]                Use a local Toolang wheel  [bare: .]
  -h, --help                      Show this message and exit

Fork a thread from an earlier run.
 
Usage: toolang <AGENT> fork [OPTIONS] <RUN>
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
  * RUN    Run id to fork through. Thread id means fork through its latest root
           run
 
Options:
      --chat  Open chat on the forked thread
  -h, --help  Show this message and exit

Rewind a thread to an earlier run.
 
Usage: toolang <AGENT> rewind [OPTIONS] <RUN>
 
Arguments:
  * AGENT  Agent name, .too file, reference, or URL
  * RUN    Run id to rewind before. Thread id means rewind before its latest
           root run
 
Options:
      --chat  Open chat on the rewound thread
  -h, --help  Show this message and exit

Compact a thread.
 
Usage: toolang <AGENT> compact [OPTIONS] [NAME=VALUE...]
 
Arguments:
  * AGENT            Agent name, .too file, reference, or URL
  * thread=<THREAD>  Named input (Text)
    begin=<BEGIN>    Named input (Text)
    end=<END>        Named input (Text)
    bare=<BARE>      Named input (Boolean)
 
Options:
      --limit <LIMIT>=<VALUE>  Set a run limit, e.g. tokens=10000. Repeat for
                               another limit
      --model <MODEL_SPEC>     Override compact.model, including model
                               parameters
      --catalog <PATH>         Use a specified model catalog
  -h, --help                   Show this message and exit

List available caps.
 
Usage: toolang [AGENT] caps [OPTIONS]
 
Arguments:
  AGENT  Local agent name; omit for root caps only
 
Options:
  -q, --query <QUERY>  Query cap collections. Repeat to add matches; see 'too
                       query'
  -h, --help           Show this message and exit

List available tools.
 
Usage: toolang tools [OPTIONS]
 
Options:
  -q, --query <QUERY>  Query tools. Repeat to add matches; see 'too query tools'
  -h, --help           Show this message and exit

List available models.
 
Usage: toolang [AGENT] models [OPTIONS]
 
Arguments:
  AGENT  Local agent name; omit for root configuration
 
Options:
      --catalog <PATH>  Use a specified model catalog
  -q, --query <QUERY>   Query models. Repeat to add matches; see 'too query
                        models'
      --json            Write filtered models as JSON
  -h, --help            Show this message and exit

List available model providers.
 
Usage: toolang providers [OPTIONS]
 
Options:
      --catalog <PATH>  Use a specified model catalog
      --json            Write catalog providers as JSON
  -h, --help            Show this message and exit

List installed model catalogs.
 
Usage: toolang catalogs [OPTIONS]
 
Options:
  -h, --help  Show this message and exit

List installed model adapters.
 
Usage: toolang adapters [OPTIONS]
 
Options:
      --json  Write adapter metadata as JSON
  -h, --help  Show this message and exit

List installed toolsets.
 
Usage: toolang toolsets [OPTIONS]
 
Options:
  -h, --help  Show this message and exit

List installed sandboxes.
 
Usage: toolang sandboxes [OPTIONS]
 
Options:
  -h, --help  Show this message and exit

Inspect agent run history.
 
Usage: toolang <AGENT> inspect [OPTIONS] <SUBJECT>...
 
Arguments:
  * AGENT    Agent name, .too file, reference, or URL
  * SUBJECT  Subject chain. Root subjects: threads, runs, controls, or POINTER.
             Relations: THREAD runs; RUN steps; STEP runs; LOOP_STEP steps.
             Projectors: RUN tree; STEP call. Run tree is a durable structural
             snapshot; Step call is the Step-owned historical call
 
Options:
      --human  Render human-readable output (default)
      --json   Render exact canonical JSON
  -h, --help   Show this message and exit