toolang

Usage: toolang [OPTIONS] COMMAND [ARGS]...
 
Run and manage Toolang agents.
 
Options:
 --root     -r      PATH  Use a custom Toolang root.
 --version  -V            Show current version and exit.
 --help                   Show this message and exit.
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.
 chore    Manage agent chores.
 task     Manage agent tasks.
Caps Commands:
 psyche   Manage psyche caps.
 skill    Manage skill caps.
 service  Manage service caps.
 prompt   Manage prompt caps.
 caps     Inspect available caps.
Runtime Commands:
 model    Inspect available models.
 tool     Inspect available tools.
 channel  Inspect available channels.
 sandbox  Inspect available sandboxes.

Usage: toolang new [OPTIONS] AGENT
 
Create an agent.
 
Arguments:
 *    agent      TEXT  Agent name [required]
Options:
 --template  -t      TEXT  Template name. [default: default]
 --help                    Show this message and exit.

Usage: toolang clone [OPTIONS] SOURCE [TARGET]
 
Clone an agent.
 
Arguments:
 *    source      TEXT      Agent source selector. [required]
      target      [TARGET]  New local agent name.
Options:
 --help          Show this message and exit.

Usage: toolang remove [OPTIONS] AGENT
 
Remove an agent.
 
Arguments:
 *    agent      TEXT  Agent name [required]
Options:
 --help          Show this message and exit.

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

Usage: toolang AGENT info [OPTIONS]
 
Show agent info.
 
Arguments:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang run [OPTIONS] AGENT
 
Run an agent in the foreground.
 
Arguments:
 *    agent      TEXT  Existing local agent name, remote agent ref, or URL.
                       [required]
Options:
 --sandbox        TEXT     Run the agent in a sandbox. [default: none]
 --models         TEXT     Limit available models. Pass CSV or repeat.
 --tools          TEXT     Allow selected tools. Pass CSV or repeat.
 --caps           TEXT     Allow selected caps. Pass CSV or repeat.
 --host           TEXT     Bind the agent API to this host.
                           [default: 127.0.0.1]
 --port           INTEGER  Bind the agent API to this port.
 --enable         TEXT     Enable runtime components. Pass CSV or repeat.
 --dev            PATH     Use wheels from this file or directory when
                           starting a sandbox.
 --help                    Show this message and exit.

Usage: toolang AGENT start [OPTIONS]
 
Start an agent.
 
Arguments:
 *    agent      TEXT  Existing local agent name. [required]
Options:
 --sandbox        TEXT     Run the agent in a sandbox. [default: none]
 --models         TEXT     Limit available models. Pass CSV or repeat.
 --tools          TEXT     Allow selected tools. Pass CSV or repeat.
 --caps           TEXT     Allow selected caps. Pass CSV or repeat.
 --host           TEXT     Bind the agent API to this host.
                           [default: 127.0.0.1]
 --port           INTEGER  Bind the agent API to this port.
 --enable         TEXT     Enable runtime components. Pass CSV or repeat.
 --dev            PATH     Use wheels from this file or directory when
                           starting a sandbox.
 --help                    Show this message and exit.

Usage: toolang AGENT stop [OPTIONS]
 
Stop an agent.
 
Arguments:
 *    agent      TEXT  Agent name. [required]
Options:
 --force    --no-force      Force-stop when graceful shutdown does not
                            complete.
                            [default: no-force]
 --help                     Show this message and exit.

Usage: toolang AGENT chore [OPTIONS] COMMAND [ARGS]...
 
Manage agent chores.
 
Options:
 --help          Show this message and exit.
Commands:
 list     List chores.
 new      Create a chore.
 edit     Edit a chore.
 pause    Pause a chore.
 resume   Resume a chore.
 archive  Archive a chore.
 restore  Restore an archived chore.
 delete   Delete an archived chore.

Usage: toolang AGENT chore list [OPTIONS]
 
List chores.
 
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --all           Include archived items.
 --help          Show this message and exit.

Usage: toolang AGENT chore new [OPTIONS]
 
Create a chore.
 
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT chore edit [OPTIONS] ID
 
Edit a chore.
 
Arguments:
 *    id      TEXT  Chore id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT chore pause [OPTIONS] ID
 
Pause a chore.
 
Arguments:
 *    id      TEXT  Chore id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT chore resume [OPTIONS] ID
 
Resume a chore.
 
Arguments:
 *    id      TEXT  Chore id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT chore archive [OPTIONS] ID
 
Archive a chore.
 
Arguments:
 *    id      TEXT  Chore id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT chore restore [OPTIONS] ID
 
Restore an archived chore.
 
Arguments:
 *    id      TEXT  Chore id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --inactive          Restore as inactive instead of active.
 --help              Show this message and exit.

Usage: toolang AGENT chore delete [OPTIONS] ID
 
Delete an archived chore.
 
Arguments:
 *    id      TEXT  Chore id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT task [OPTIONS] COMMAND [ARGS]...
 
Manage agent tasks.
 
Options:
 --help          Show this message and exit.
Commands:
 list     List tasks.
 new      Create a task.
 edit     Edit a task.
 pause    Pause a task.
 resume   Resume a task.
 archive  Archive a task.
 restore  Restore an archived task.
 delete   Delete an archived task.

Usage: toolang AGENT task list [OPTIONS]
 
List tasks.
 
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --all           Include archived items.
 --help          Show this message and exit.

Usage: toolang AGENT task new [OPTIONS]
 
Create a task.
 
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT task edit [OPTIONS] ID
 
Edit a task.
 
Arguments:
 *    id      TEXT  Task id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT task pause [OPTIONS] ID
 
Pause a task.
 
Arguments:
 *    id      TEXT  Task id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT task resume [OPTIONS] ID
 
Resume a task.
 
Arguments:
 *    id      TEXT  Task id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT task archive [OPTIONS] ID
 
Archive a task.
 
Arguments:
 *    id      TEXT  Task id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang AGENT task restore [OPTIONS] ID
 
Restore an archived task.
 
Arguments:
 *    id      TEXT  Task id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --inactive          Restore as inactive instead of active.
 --help              Show this message and exit.

Usage: toolang AGENT task delete [OPTIONS] ID
 
Delete an archived task.
 
Arguments:
 *    id      TEXT  Task id [required]
Scope:
 *    agent      TEXT  Agent name. [required]
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] psyche [OPTIONS] COMMAND [ARGS]...
 
Manage psyche caps.
 
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --help          Show this message and exit.
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.

Usage: toolang [AGENT] psyche list [OPTIONS]
 
List psyches.
 
Scope:
   agent      TEXT  Also include this agent's psyches.
Options:
 --filter  -f      TEXT  Filter caps with selector-list syntax.
 --help                  Show this message and exit.

Usage: toolang [AGENT] psyche new [OPTIONS] NAME
 
Create a file-backed psyche.
 
Arguments:
 *    name      TEXT  Psyche name [required]
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --template  -t      TEXT  Template name. [default: default]
 --help                    Show this message and exit.

Usage: toolang [AGENT] psyche edit [OPTIONS] NAME
 
Edit a file-backed psyche.
 
Arguments:
 *    name      TEXT  Psyche name [required]
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] psyche delete [OPTIONS] NAME
 
Delete a file-backed psyche.
 
Arguments:
 *    name      TEXT  Psyche name [required]
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] psyche add [OPTIONS] REF
 
Wire a psyche ref.
 
Arguments:
 *    ref      TEXT  Psyche ref [required]
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] psyche remove [OPTIONS] NAME
 
Unwire a psyche.
 
Arguments:
 *    name      TEXT  Psyche name [required]
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] psyche template [OPTIONS] [NAME]
 
Inspect psyche templates.
 
Arguments:
   name      TEXT  Template name.
Scope:
   agent      TEXT  Apply to this agent's psyches instead of root psyches.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] skill [OPTIONS] COMMAND [ARGS]...
 
Manage skill caps.
 
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --help          Show this message and exit.
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.

Usage: toolang [AGENT] skill list [OPTIONS]
 
List skills.
 
Scope:
   agent      TEXT  Also include this agent's skills.
Options:
 --filter  -f      TEXT  Filter caps with selector-list syntax.
 --help                  Show this message and exit.

Usage: toolang [AGENT] skill new [OPTIONS] NAME
 
Create a file-backed skill.
 
Arguments:
 *    name      TEXT  Skill name [required]
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --template  -t      TEXT  Template name. [default: default]
 --help                    Show this message and exit.

Usage: toolang [AGENT] skill edit [OPTIONS] NAME
 
Edit a file-backed skill.
 
Arguments:
 *    name      TEXT  Skill name [required]
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] skill delete [OPTIONS] NAME
 
Delete a file-backed skill.
 
Arguments:
 *    name      TEXT  Skill name [required]
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] skill add [OPTIONS] REF
 
Wire a skill ref.
 
Arguments:
 *    ref      TEXT  Skill ref [required]
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] skill remove [OPTIONS] NAME
 
Unwire a skill.
 
Arguments:
 *    name      TEXT  Skill name [required]
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] skill template [OPTIONS] [NAME]
 
Inspect skill templates.
 
Arguments:
   name      TEXT  Template name.
Scope:
   agent      TEXT  Apply to this agent's skills instead of root skills.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] service [OPTIONS] COMMAND [ARGS]...
 
Manage service caps.
 
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --help          Show this message and exit.
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.

Usage: toolang [AGENT] service list [OPTIONS]
 
List services.
 
Scope:
   agent      TEXT  Also include this agent's services.
Options:
 --filter  -f      TEXT  Filter caps with selector-list syntax.
 --help                  Show this message and exit.

Usage: toolang [AGENT] service new [OPTIONS] NAME
 
Create a file-backed service.
 
Arguments:
 *    name      TEXT  Service name [required]
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --template  -t      TEXT  Template name. [default: default]
 --help                    Show this message and exit.

Usage: toolang [AGENT] service edit [OPTIONS] NAME
 
Edit a file-backed service.
 
Arguments:
 *    name      TEXT  Service name [required]
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] service delete [OPTIONS] NAME
 
Delete a file-backed service.
 
Arguments:
 *    name      TEXT  Service name [required]
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] service add [OPTIONS] REF
 
Wire a service ref.
 
Arguments:
 *    ref      TEXT  Service ref [required]
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] service remove [OPTIONS] NAME
 
Unwire a service.
 
Arguments:
 *    name      TEXT  Service name [required]
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] service template [OPTIONS] [NAME]
 
Inspect service templates.
 
Arguments:
   name      TEXT  Template name.
Scope:
   agent      TEXT  Apply to this agent's services instead of root services.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] prompt [OPTIONS] COMMAND [ARGS]...
 
Manage prompt caps.
 
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --help          Show this message and exit.
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.

Usage: toolang [AGENT] prompt list [OPTIONS]
 
List prompts.
 
Scope:
   agent      TEXT  Also include this agent's prompts.
Options:
 --filter  -f      TEXT  Filter caps with selector-list syntax.
 --help                  Show this message and exit.

Usage: toolang [AGENT] prompt new [OPTIONS] NAME
 
Create a file-backed prompt.
 
Arguments:
 *    name      TEXT  Prompt name [required]
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --template  -t      TEXT  Template name. [default: default]
 --help                    Show this message and exit.

Usage: toolang [AGENT] prompt edit [OPTIONS] NAME
 
Edit a file-backed prompt.
 
Arguments:
 *    name      TEXT  Prompt name [required]
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] prompt delete [OPTIONS] NAME
 
Delete a file-backed prompt.
 
Arguments:
 *    name      TEXT  Prompt name [required]
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] prompt add [OPTIONS] REF
 
Wire a prompt ref.
 
Arguments:
 *    ref      TEXT  Prompt ref [required]
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] prompt remove [OPTIONS] NAME
 
Unwire a prompt.
 
Arguments:
 *    name      TEXT  Prompt name [required]
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] prompt template [OPTIONS] [NAME]
 
Inspect prompt templates.
 
Arguments:
   name      TEXT  Template name.
Scope:
   agent      TEXT  Apply to this agent's prompts instead of root prompts.
Options:
 --help          Show this message and exit.

Usage: toolang [AGENT] caps [OPTIONS]
 
Inspect available caps.
 
Scope:
   agent      TEXT  Also include this agent's caps.
Options:
 --filter  -f      TEXT  Filter caps with selector-list syntax.
 --help                  Show this message and exit.

Usage: toolang model [OPTIONS] COMMAND [ARGS]...
 
Inspect available models.
 
Options:
 --help          Show this message and exit.
Commands:
 list       List available models.
 providers  Show configured model providers.
 adapters   List available model API adapters.

Usage: toolang model list [OPTIONS]
 
List available models.
 
Options:
 --filter,--select  -f      TEXT  Filter models with selector-list syntax.
                                  Pass CSV or repeat.
 --help                           Show this message and exit.

Usage: toolang model providers [OPTIONS]
 
Show configured model providers.
 
Options:
 --help          Show this message and exit.

Usage: toolang model adapters [OPTIONS]
 
List available model API adapters.
 
Options:
 --help          Show this message and exit.

Usage: toolang tool [OPTIONS] COMMAND [ARGS]...
 
Inspect available tools.
 
Options:
 --help          Show this message and exit.
Commands:
 list  List available tools.

Usage: toolang tool list [OPTIONS]
 
List available tools.
 
Options:
 --filter,--select  -f      TEXT  Filter tools with selector-list syntax.
                                  Pass CSV or repeat.
 --help                           Show this message and exit.

Usage: toolang channel [OPTIONS] COMMAND [ARGS]...
 
Inspect available channels.
 
Options:
 --help          Show this message and exit.
Commands:
 list  List installed channels.

Usage: toolang channel list [OPTIONS]
 
List installed channels.
 
Options:
 --help          Show this message and exit.

Usage: toolang sandbox [OPTIONS] COMMAND [ARGS]...
 
Inspect available sandboxes.
 
Options:
 --help          Show this message and exit.
Commands:
 list  List installed sandboxes.

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