Skip to content
Agent
AGH RuntimeAgent

agh agent update

Update an agent definition for future sessions

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

agh agent update

Update an agent definition for future sessions

agh agent update <name> [flags]

Options

      --category stringArray        Agent category path segment (repeatable)
      --command string              Optional provider command override
      --deny-tool stringArray       Denied tool pattern (repeatable)
      --disable-skill stringArray   Disabled skill name (repeatable)
      --expected-digest string      Definition digest from the last read
  -h, --help                        help for update
      --model string                Optional provider model
      --permissions string          Optional permission mode
      --prompt string               Agent system prompt body
      --prompt-file string          Read the agent system prompt body from a file
      --provider string             Provider name for sessions using this agent
      --reasoning-effort string     Optional default reasoning effort
      --tool stringArray            Allowed tool pattern (repeatable)
      --toolset stringArray         Allowed toolset reference (repeatable)
      --workspace string            Resolve the effective agent from a workspace

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 agent update <name> -o json

On this page