Skip to content
Memory
CompozyOS RuntimeMemory

compozy memory edit

Edit a Memory v2 entry through the controller

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

compozy memory edit

Edit a Memory v2 entry through the controller

compozy memory edit <filename> --content <@file|text> [flags]

Options

      --agent string         Agent name for agent-scoped memory
      --agent-tier string    Agent memory tier: workspace or global
      --content string       Memory content; use @file to read from disk or - for stdin
      --description string   Memory description override
      --dry-run              Ask the controller for a decision without applying it
  -h, --help                 help for edit
      --name string          Memory display name override
      --scope string         Memory scope: global, workspace, or agent
      --type string          Memory type override
      --workspace string     Override workspace binding (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 Compozy 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:

compozy memory edit <filename> --content <@file|text> -o json

On this page