Skip to content
Tool
AGH RuntimeTool

agh tool invoke

Invoke one registry tool through daemon policy

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

agh tool invoke

Invoke one registry tool through daemon policy

agh tool invoke <tool_id> [flags]

Examples

  # Invoke a tool with inline JSON input
  agh tool invoke agh__tool_info --input '{"tool_id":"agh__skill_view"}' -o json

  # Invoke a tool with JSON read from a file
  agh tool invoke agh__tool_info --input-file ./input.json -o json

  # Invoke a tool with JSON read from stdin
  echo '{"tool_id":"agh__skill_view"}' | agh tool invoke agh__tool_info -o json

Options

      --agent string                        Agent name for scoped diagnostics
      --approval-token string               Single-use approval token for approval-gated tools
      --correlation-id string               Optional correlation id
  -h, --help                                help for invoke
      --input string                        Inline JSON input
      --input-file string                   Path to JSON input file, or '-' for stdin
      --sensitive-input-field stringArray   Input field path to redact in events
      --session string                      Session id for scoped diagnostics
      --tool-call-id string                 Optional caller tool-call id
      --turn-id string                      Optional caller turn id
      --workspace string                    Workspace id for scoped diagnostics

Options inherited from parent commands

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

Output Formats

Every AGH 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:

agh tool invoke <tool_id> -o json

On this page