AOMA Memory Commands
Manage long-term memory across projects using AOMA (Append-Only Memory Architecture), a SQLite-backed multi-project memory store aligned with arxiv:2602.20478.
What is AOMA?
AOMA (Append-Only Memory Architecture) is a SQLite-backed memory store that provides persistent, multi-project memory for CCO. It enables agents to retain learnings across sessions without relying on token-heavy context.
AOMA Architecture
3-tier memory aligned with arxiv:2602.20478
- Raw memories - Initial ingestions stored verbatim
- Consolidation - Raw memories distilled into active insights
- Multi-project - Isolated namespaces per project via project-switch
cco mem add
Add a new entry to AOMA memory store.
| Parameter | Type | Description |
|---|---|---|
--text |
string (required) | The memory content to store |
--source-ref |
string | Reference identifier for the source (e.g., URL, file path) |
--source-type |
string | Type of source (default: "manual") |
cco mem add --text "Remember to validate API keys" --source-type manual cco mem add --text "Rate limiting: 100 req/min for standard tier" --source-ref "https://api.example.com/docs" --source-type documentation
cco mem ask
Query AOMA memory store for relevant information.
| Parameter | Type | Description |
|---|---|---|
--query |
string (required) | Natural language query to search memory store |
--limit |
integer | Maximum number of memory records to return (default: 5) |
--use-llm |
flag | Use LLM for enhanced query processing |
--json |
flag | Output results as JSON |
cco mem ask --query "API validation best practices" cco mem ask --query "security patterns" --limit 10 --json
cco mem consolidate
Trigger memory consolidation process. Converts raw memories into active distilled insights.
Consolidation runs asynchronously. Use cco mem status to check progress.
cco mem consolidate
cco mem status
Show AOMA memory system status and statistics including record counts, model info, and database path.
| Parameter | Type | Description |
|---|---|---|
--json |
flag | Output status as JSON |
cco mem status cco mem status --json
cco mem list
List memory entries with optional status filter and pagination.
| Parameter | Type | Description |
|---|---|---|
--status |
string | Filter by status: active, raw, archived, failed_consolidation |
--limit |
integer | Maximum number of records to return (default: 20) |
--offset |
integer | Offset for pagination (default: 0) |
--json |
flag | Output results as JSON |
cco mem list cco mem list --status active --limit 50 cco mem list --status raw --offset 20 --json
cco mem project-switch
Switch the current memory project namespace. Each project has isolated memory records.
| Parameter | Type | Description |
|---|---|---|
--project |
string (required) | Project namespace name to switch to |
--persist |
flag | Persist the project selection (default: True) |
--no-persist |
flag | Do not persist the project selection |
cco mem project-switch --project myrepo cco mem project-switch --project workproject --no-persist
cco mem project-show
Show the current memory project namespace.
| Parameter | Type | Description |
|---|---|---|
--json |
flag | Output current project as JSON |
cco mem project-show cco mem project-show --json
cco mem export
Export AOMA memories to markdown files for backup or inspection.
| Parameter | Type | Description |
|---|---|---|
--date |
string | Filter exports by date (ISO format) |
--json |
flag | Output as JSON instead of markdown |
cco mem export cco mem export --date 2026-05-01 --json
cco mem sync
Import markdown memory files into AOMA store.
| Parameter | Type | Description |
|---|---|---|
--source |
string (required) | Source directory or file path to import from |
--json |
flag | Output results as JSON |
cco mem sync --source ./memory-backup/ cco mem sync --source ./memories.md --json
cco mem suggest
Suggest which specialized agent should handle a task based on historical memory patterns.
| Parameter | Type | Description |
|---|---|---|
--task |
string (required) | Task description to analyze |
--limit |
integer | Maximum number of suggestions (default: 5) |
--json |
flag | Output suggestions as JSON |
cco mem suggest --task "Add rate limiting to API" cco mem suggest --task "Fix authentication bug" --limit 3 --json