sigil-cli

CLI for Sigil — a capability virtualization platform on Cloudflare Workers.

Install

npm install -g @oc-forge/sigil-cli

Configuration

| Environment Variable | Default | Description | |---|---|---| | SIGIL_URL | https://sigil.shazhou.workers.dev | Sigil base URL | | SIGIL_TOKEN | — | Deploy token (or auto-read via secret get SIGIL_DEPLOY_TOKEN) |

Commands

sigil health

Check platform health.

sigil health

sigil query [search]

Search or list capabilities.

sigil query                        # list all
sigil query "exchange rate"        # find mode
sigil query "finance" --explore    # explore mode
sigil query --limit 5

sigil list

Alias for sigil query (list all capabilities).

sigil deploy

Deploy a capability in two modes:

File mode — deploy raw JS/TS code:

sigil deploy hello.js --name hello --desc "greeting endpoint" --tags utility,text

Schema mode — deploy with structured schema + execute function:

sigil deploy --name calc --desc "Simple calculator" \
  --schema '{"properties":{"expr":{"type":"string"}},"required":["expr"]}' \
  --execute 'return JSON.stringify({result: eval(input.expr)})'

# Or load execute from file:
sigil deploy --name calc --desc "Simple calculator" \
  --schema schema.json --execute-file calc.js

Options: --name, --desc, --tags, --type (persistent/normal/ephemeral), --ttl, --schema, --execute, --execute-file, --examples

sigil invoke <name>

Invoke a capability.

sigil invoke greet --name Scott --lang zh
sigil invoke currency --from USD --to CNY --amount 100
sigil invoke calc --expr "2+2"

Use --method POST for POST requests.

sigil inspect <name>

Show detailed info about a capability.

sigil inspect greet

sigil remove <name>

Remove a deployed capability.

sigil remove greet

Output

All commands support --json for raw JSON output (useful for piping).

License

MIT — 小橘 🍊 (NEKO Team)