Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

caps

Manage composable agent primitives.

Usage

Usage: caps [AGENT] [OPTIONS] COMMAND [ARGS]...
 
Manage composable agent primitives.
 
Scope:
   agent      TEXT  Apply to this agent's caps instead of root caps.
Options:
 --root     -r      PATH  Use a custom Toolang root.
 --version  -V            Show current version and exit.
 --help                   Show this message and exit.
Commands:
 list     Inspect available caps.
 psyche   Manage psyche caps.
 skill    Manage skill caps.
 service  Manage service caps.
 prompt   Manage prompt caps.

caps list

Inspect available caps.

Usage: caps [AGENT] list [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.

caps psyche

Manage psyche caps.

Usage: caps [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.

caps psyche list

List psyches.

Usage: caps [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.

caps psyche new

Create a file-backed psyche.

Usage: caps [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.

caps psyche edit

Edit a file-backed psyche.

Usage: caps [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.

caps psyche delete

Delete a file-backed psyche.

Usage: caps [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.

caps psyche add

Wire a psyche ref.

Usage: caps [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.

caps psyche remove

Unwire a psyche.

Usage: caps [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.

caps psyche template

Inspect psyche templates.

Usage: caps [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.

caps skill

Manage skill caps.

Usage: caps [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.

caps skill list

List skills.

Usage: caps [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.

caps skill new

Create a file-backed skill.

Usage: caps [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.

caps skill edit

Edit a file-backed skill.

Usage: caps [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.

caps skill delete

Delete a file-backed skill.

Usage: caps [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.

caps skill add

Wire a skill ref.

Usage: caps [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.

caps skill remove

Unwire a skill.

Usage: caps [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.

caps skill template

Inspect skill templates.

Usage: caps [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.

caps service

Manage service caps.

Usage: caps [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.

caps service list

List services.

Usage: caps [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.

caps service new

Create a file-backed service.

Usage: caps [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.

caps service edit

Edit a file-backed service.

Usage: caps [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.

caps service delete

Delete a file-backed service.

Usage: caps [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.

caps service add

Wire a service ref.

Usage: caps [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.

caps service remove

Unwire a service.

Usage: caps [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.

caps service template

Inspect service templates.

Usage: caps [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.

caps prompt

Manage prompt caps.

Usage: caps [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.

caps prompt list

List prompts.

Usage: caps [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.

caps prompt new

Create a file-backed prompt.

Usage: caps [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.

caps prompt edit

Edit a file-backed prompt.

Usage: caps [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.

caps prompt delete

Delete a file-backed prompt.

Usage: caps [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.

caps prompt add

Wire a prompt ref.

Usage: caps [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.

caps prompt remove

Unwire a prompt.

Usage: caps [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.

caps prompt template

Inspect prompt templates.

Usage: caps [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.
© 2026 Toolang