Skip to content
Core ConceptsCLI ReferenceAPI Reference
Agent
AGH RuntimeAgent

agh agent delete

Durably delete an agent definition

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

agh agent delete

Durably delete an agent definition

agh agent delete <name> [flags]

Options

  -h, --help               help for delete
      --workspace string   Resolve the effective agent from a workspace
      --yes                Confirm durable deletion without prompting

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 delete <name> -o json

agh agent create

Create a global or workspace-local agent definition

agh agent duplicate

Duplicate an agent definition without exposing secrets

On this page

agh agent deleteOptionsOptions inherited from parent commandsOutput Formats