Skip to content

compozy memory write

Create a Memory v2 entry through the controller

For people running agent work51 pages in this section

compozy memory write

Create a Memory v2 entry through the controller

compozy memory write --type <type> --name <name> --content <@file|text> [flags]

Examples

  # Write workspace-scoped project memory from a file
  compozy memory write --scope workspace --type project --name "Runtime docs" --content @runtime.md

  # Write agent-global feedback
  compozy memory write --scope agent --agent reviewer --agent-tier global \
    --type feedback --name "Review tone" --content @feedback.md

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   One-line durable memory description
      --dry-run              Ask the controller for a decision without applying it
  -h, --help                 help for write
      --name string          Memory display name
      --scope string         Memory scope: global, workspace, or agent
      --type string          Memory type: user, feedback, project, or reference
      --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

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy memory write --type <type> --name <name> --content <@file|text> -o json

On this page