Skip to content
Core ConceptsCLI ReferenceAPI Reference
Tool
CompozyOS RuntimeTool

compozy tool approve

Mint a one-shot approval token for one tool invocation

Audience
Operators running durable agent work
Focus
Tool guidance shaped for scanability, day-two clarity, and operator context.

compozy tool approve

Mint a one-shot approval token for one tool invocation

compozy tool approve <tool_id> [flags]

Options

      --agent string          Agent name for scoped diagnostics
  -h, --help                  help for approve
      --input string          Inline JSON input
      --input-digest string   Precomputed input digest
      --input-file string     Path to JSON input file, or '-' for stdin
      --session string        Session id for scoped diagnostics
      --workspace string      Override workspace diagnostics (ID, name, or path)

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every Compozy command supports -o, --output:

  • human for interactive terminal use
  • json for scripts and other machine-readable consumers
  • jsonl for wait or streaming commands that emit one JSON record per line
  • toon for compact agent-readable summaries

Example:

compozy tool approve <tool_id> -o json

compozy tool

Inspect and invoke registry tools

compozy tool info

Show one registry tool descriptor and diagnostics

On this page

compozy tool approveOptionsOptions inherited from parent commandsOutput Formats