tools

Catalog discovery

• brigade tools init writes gitignored .brigade/tools.toml with local examples for portable slash commands and superpowers.
• brigade tools list, show <tool-id>, and search <query> inspect logical tool entries across source families such as skill, slash-command, superpower, mcp, openapi, graphql, script, and custom.
• brigade tools describe <tool-id> and brigade tools contracts inspect schema-backed call contracts, permissions, effects, approval mode, env labels, and argument templates.

brigade tools init
brigade tools list
brigade tools show simplify
brigade tools search simplify
brigade tools describe simplify
brigade tools contracts

Call planning and approval

• brigade tools call plan <tool-id> --args ... validates local JSON args against the configured input schema and returns a redacted wrapper-friendly call plan without executing the tool.
• brigade tools call queue/list/show/approve/reject/hold stores planned calls in .brigade/tools/calls.jsonl for local review. Approval changes status only and never executes a tool.
• brigade tools call run <call-id> and brigade tools call run --next execute approved, unblocked local script calls and approved local mcp calls, then write local receipts and stdout/stderr logs under .brigade/tools/runs/.

brigade tools call plan simplify --args '{"path":"README.md"}'
brigade tools call queue simplify --args '{"path":"README.md"}'
brigade tools call list
brigade tools call show <call-id>
brigade tools call approve <call-id>
brigade tools call reject <call-id> --reason "not needed"
brigade tools call hold <call-id> --reason "needs review"
brigade tools call run <call-id>
brigade tools call run --next

Run history and checkpoints

• brigade tools run list/show/latest inspects local execution receipts, and brigade tools run replay <run-id> creates a new pending reviewed replay candidate after revalidating current contract, source, runtime, and policy state. Replay never reruns directly.
• brigade tools checkpoint list/show/approve/reject/resume reviews script-requested local checkpoints under .brigade/tools/checkpoints/; resume requires explicit checkpoint approval and revalidates runtime and policy gates.

brigade tools run list
brigade tools run show <run-id>
brigade tools run latest
brigade tools run replay <run-id>
brigade tools checkpoint list
brigade tools checkpoint show <checkpoint-id>
brigade tools checkpoint approve <checkpoint-id> --choice continue
brigade tools checkpoint reject <checkpoint-id> --reason "not safe"
brigade tools checkpoint resume <checkpoint-id>

Runtimes and policy

• brigade tools runtime init/list/show/status/start/stop/restart/doctor manages explicit local runtimes used by portable tool calls, writing PID files and logs under .brigade/tools/runtime/.
• brigade tools policy init/show/doctor manages host-local execution policy, including allowed effects, timeout caps, runtime allow-lists, approval modes, and environment label bindings.

brigade tools runtime init
brigade tools runtime list
brigade tools runtime status
brigade tools runtime start <runtime-id>
brigade tools runtime stop <runtime-id>
brigade tools runtime doctor
brigade tools policy init
brigade tools policy show
brigade tools policy doctor

Projections, apply, and doctor

• brigade tools plan previews exact projection creates, updates, skips, unmanaged conflicts, and local-edit conflicts for all configured harness targets.
• brigade tools apply <tool-id> and brigade tools apply --all explicitly write managed harness projections. Use --dry-run to preview writes and --force only to overwrite unmanaged or locally edited projection files.
• brigade tools doctor reports missing sources, manifests, schemas, invalid contracts, missing examples, bad argument templates, projections, unmanaged projections, locally edited managed projections, stale projection fingerprints, MCP config issues, stale health files, unsafe auth/env field names, and high-risk command shapes.
• brigade tools import-issues turns catalog health issues into local tool-catalog work imports with stable fingerprints and dismiss-until-changed behavior.

brigade tools plan
brigade tools plan simplify
brigade tools apply simplify --dry-run
brigade tools apply simplify
brigade tools apply --all
brigade tools doctor
brigade tools import-issues

Tool catalog inspection, call planning, call approval review, run history inspection, and checkpoint review are non-executing, and projection writes are always explicit through brigade tools apply. Tool call execution is explicit through brigade tools call run, limited to approved local script entries and approved local mcp entries with already-running managed runtimes. Brigade does not connect to remote MCP servers, fetch OpenAPI or GraphQL schemas, store auth, install schedulers, send approval notifications, or auto-sync harness configs. Keep tokens, secrets, private URLs, and host-private paths out of public catalog templates.