Skip to content

compozy memory promote

Promote a memory entry across Memory v2 scopes

For people running agent work51 pages in this section

compozy memory promote

Promote a memory entry across Memory v2 scopes

compozy memory promote <filename> --from <scope[:tier]> --to <scope[:tier]> [flags]

Options

      --agent string        Agent name for agent-scoped memory
      --agent-tier string   Agent memory tier: workspace or global
      --dry-run             Ask for a promotion decision without applying it
      --from string         Source scope: global, workspace, agent:workspace, or agent:global
  -h, --help                help for promote
      --scope string        Memory scope: global, workspace, or agent
      --to string           Destination scope: global, workspace, agent:workspace, or agent:global
      --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 promote <filename> --from <scope[:tier]> --to <scope[:tier]> -o json

On this page