Memory
AGH RuntimeMemory
agh memory promote
Promote a memory entry across Memory v2 scopes
- Audience
- Operators running durable agent work
- Focus
- Memory guidance shaped for scanability, day-two clarity, and operator context.
agh memory promote
Promote a memory entry across Memory v2 scopes
agh 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 Workspace ID or path for workspace-bound memoryOptions 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:
humanfor interactive terminal usejsonfor scripts and other machine-readable consumersjsonlfor wait or streaming commands that emit one JSON record per linetoonfor compact agent-readable summaries
Example:
agh memory promote <filename> --from <scope[:tier]> --to <scope[:tier]> -o json