Skip to content
Core ConceptsCLI ReferenceAPI Reference
Memory
AGH RuntimeMemory

agh memory list

List Memory v2 entries

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

agh memory list

List Memory v2 entries

agh memory list [flags]

Examples

  # List global and current-workspace memories
  agh memory list

  # List agent-workspace memories
  agh memory list --scope agent --agent reviewer --agent-tier workspace

Options

      --agent string        Agent name for agent-scoped memory
      --agent-tier string   Agent memory tier: workspace or global
  -h, --help                help for list
      --include-shadowed    Include shadowed entries
      --include-system      Include _system memory entries
      --scope string        Memory scope: global, workspace, or agent
      --type string         Memory type: user, feedback, project, or reference
      --workspace string    Workspace ID or path for workspace-bound memory

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 memory list -o json

agh memory history

Show redaction-safe Memory v2 operation history

agh memory promote

Promote a memory entry across Memory v2 scopes

On this page

agh memory listExamplesOptionsOptions inherited from parent commandsOutput Formats