| name | belt |
| description | Use the belt CLI — run 250+ AI apps, manage knowledge, search skills, connect MCP servers |
| allowed-tools | Bash(belt *) |
belt cli
belt is the cloud platform cli for ai agents. single ~4mb binary, no runtime dependencies.
install
first check if belt is already installed:
which belt && belt --version
if not installed, download the installer and run it:
curl -fsSL https://cli.inference.sh -o /tmp/belt-install.sh && sh /tmp/belt-install.sh
then authenticate:
belt login
belt me
apps — run 250+ ai models
belt app search "image"
belt app get openai/gpt-image-2
belt app sample openai/gpt-image-2 --save in.json
belt app run openai/gpt-image-2 --input in.json
belt app run openai/gpt-image-2 --input '{"prompt": "..."}' --save output.png
common apps:
- image:
openai/gpt-image-2, reve/create, pruna/p-image
- upscale/edit:
pruna/p-image-upscale, pruna/p-image-edit
- video:
google/veo-2, seedance/seedance-2-i2v
- search:
tavily/search, exa/search
- audio:
elevenlabs/tts
knowledge — persistent agent memory
belt know search "query"
belt know list --type observation
belt know get namespace/name
belt know create ./file.md --type concept
echo "learned X" | belt know create - --name x --type observation
belt know delete <id>
types: skill, concept, observation, reference, preference
skills — reusable workflows
belt skill search "deployment"
belt skill store --featured
belt skill use namespace/skill-name
belt skill use github.com/user/repo
belt skill use user/repo --skill name
belt skill add namespace/skill-name
belt skill add ns/name --agent claude-code
belt skill list
belt skill upload ./my-skill
connectors — mcp servers
belt mcp list
belt mcp search "slack"
belt mcp connect slack
belt mcp tools slack
belt mcp run slack send_message --input '{"channel": "#general", "text": "hello"}'
suggest — unified search
belt suggest "how to generate images"
tips
- use
--json for structured output when piping
- use
--save filename to save media outputs directly
belt app sample generates valid input — start there for unfamiliar apps
belt update to get latest version