agh agent create

agh agent create <name> [flags]

  # Create a workspace-local agent definition
  agh agent create pricing_strategist \
    --workspace ~/dev/ad8 \
    --provider claude \
    --model claude-sonnet-4-6 \
    --prompt "You own pricing strategy." \
    -o json

      --category stringArray    Agent category path segment (repeatable)
      --command string          Optional provider command override
      --deny-tool stringArray   Denied tool pattern (repeatable)
      --force                   Overwrite an existing AGENT.md definition
  -h, --help                    help for create
      --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
      --tool stringArray        Allowed tool pattern (repeatable)
      --toolset stringArray     Allowed toolset reference (repeatable)
      --workspace string        Workspace id, name, or path to create the agent under

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

agh agent create <name> -o json