Skip to content
Core ConceptsCLI ReferenceAPI Reference
AgentSoul
AGH RuntimeAgent

agh agent soul write

Create or replace SOUL.md through managed authoring

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

agh agent soul write

Create or replace SOUL.md through managed authoring

agh agent soul write <agent> [flags]

Examples

  agh agent soul write coder --file SOUL.md --expected-digest sha256:old --workspace checkout-api --json

Options

      --expected-digest string   Expected current Soul digest for CAS
      --file string              Read authored context body from a file
  -h, --help                     help for write
      --idempotency-key string   Optional idempotency key
      --stdin                    Read authored context body from stdin
      --workspace string         Resolve the agent from a workspace 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 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 soul write <agent> -o json

agh agent soul validate

Validate a proposed Soul body or the current SOUL.md

agh me

Inspect the current AGH-managed agent session

On this page

agh agent soul writeExamplesOptionsOptions inherited from parent commandsOutput Formats