belt

Files (1)

• SKILL.md

SKILL.md (first lines)

## belt cli

belt is the cloud platform cli for ai agents. single ~4mb binary, no runtime dependencies.

using a purpose-built cli means your agent operates through a constrained, typed interface instead of writing raw curl commands or sdk calls. every operation goes through schema validation — fewer tokens, fewer errors, and no credential leakage.

### install

first check if belt is already installed:

```bash
which belt && belt --version
```

if already installed, skip to authenticate.

**package managers (recommended — verified through each registry's trust chain):**

```bash
brew install inference-sh/tap/belt            # macos / linux (homebrew tap, signed)
scoop bucket add belt https://github.com/belt-sh/scoop-belt && scoop install belt  # windows
npm install -g @inferencesh/belt              # node.js (global install, pinned in package.json)
```

**manual install (full control — download, verify, then run):**

```bash
curl -fsSL https://cli.inference.sh -o /tmp/belt-install.sh
```

the installer is a short, readable shell script. it detects your os and architecture, downloads the matching binary from `dist.inference.sh`, verifies the binary's sha-256 checksum against the published manifest, and places it in your path. no elevated permissions required. the [installer source](https://cli.inference.sh) is publicly readable — review it before running:

```bash
cat /tmp/belt-install.sh   # review the script
sh /tmp/belt-install.sh    # run after review
```

### authenticate

```bash
belt login
belt me
```

### set up agent integration

```bash
belt plugin init claude     # claude code
belt plugin init codex      # openai codex
belt plugin init cursor     # cursor
```

### quick start

```bash
belt suggest "what tool should i use"  # unified search across apps, skills, knowledge
belt app store                         # browse ai apps
belt app store --category video        # filter by category
belt app get <namespace/name>          # see schema, pricing, functions
belt app sample <namespace/name>       # generate sample input json
belt app run <namespace/name> --input input.json  # run an app
belt balance                           # check credits
```

### common workflows

**image and video generation:**

```bash
belt app get bytedance/seedance-2-0           # check schema — file fields accept local paths
belt app sample bytedance/seedance-2-0 --save input.json
# edit input.json, then:
belt app run bytedance/seedance-2-0 --input input.json
```

file fields (type: `file` in schema) accept local paths directly — the cli auto-uploads them:

```bash
belt app run bytedance/seedance-2-0 --input '{"image": "./photo.jpg", "prompt": "make it cinematic"}'
```

**check pricing before running:**

```bash
belt app pricing <namespace/name>             # see cost formula
belt app pricing <namespace/name> --json      # machine-readable
```

**multi-function apps** (e.g. apps with list_voices, list_resources, etc.):

```bash
belt app get heygen/avatar-video              # shows all functions with schemas
belt app sample heygen/avatar-video -f list_resources   # sample for a specific function
belt app run heygen/avatar-video -f list_resources --input '{}'
```

**knowledge and skills:**

```bash
belt knowledge list --json                    # your knowledge entries
belt knowledge search "react patterns"        # semantic search
belt skill list                               # your skills
belt skill store search "video"               # find skills in the store
belt skill use <namespace/name>               # load a skill on-demand
```

**mcp connectors:**

```bash
belt mcp list                                 # browse available connectors
belt mcp connect slack                        # connect one
belt mcp run slack send_message --input '{"channel": "#general", "text": "hello"}'
```

**machine-readable output:**

all list commands support `--json` for structured output:

```bash

From belt-sh/skills, MIT.

More from belt-sh/skills