Memory Commands

CLI Reference

CLI commands for managing Diverga's memory system

"Control your context with precision commands"

Interactive Demo

Try memory commands in a live terminal simulator:

CLI Command Demo

terminal

Key Commands

notepad_readRead memory

notepad_write_prioritySave priority

notepad_write_workingSave working

notepad_write_manualSave manual

Command Categories

Memory commands are organized into five categories:

Session Commands

Manage current session state

/diverga:memory status/diverga:memory context

Storage Commands

Save and persist memory

/diverga:memory decision add/note <text>/remember <text>

Retrieval Commands

Search and recall memory

/diverga:memory decision list/diverga:memory context

Maintenance Commands

Clean and refresh memory

/diverga:memory clear/diverga:memory refresh

Archive Commands

Archive completed stages

/diverga:memory archive [STAGE]/diverga:memory export

Command Details

Comprehensive reference for all memory commands:

/diverga:memory statusSession

Display current project status and active memory

Usage:

/diverga:memory status

Output:

Project name, current stage, checkpoint progress, memory health

💡 Example

Shows: Project "AI Education" | Stage: Literature Review | Checkpoint 3/7 | Memory: 12 contexts loaded

/diverga:memory contextSession

Display full loaded memory context

Usage:

/diverga:memory context [--detailed]

Output:

All loaded memory with timestamps and sources

💡 Example

Use --detailed flag for verbose output with decision rationale

/diverga:memory initSession

Initialize new project memory

Usage:

/diverga:memory init

Output:

Creates .research/ directory structure

💡 Example

Run once at project start to set up memory system

/diverga:memory decision listRetrieval

List all checkpoint decisions

Usage:

/diverga:memory decision list [--stage STAGE]

Output:

Chronological list of decisions with timestamps

💡 Example

Filter by stage: /diverga:memory decision list --stage A1

/diverga:memory decision addStorage

Manually add a decision to the log

Usage:

/diverga:memory decision add

Output:

Interactive prompt to record decision

💡 Example

Use when making important methodological choices outside checkpoints

/note <text>Storage

Save quick note to Working Memory (auto-pruned 7 days)

Usage:

/note "Found interesting paper on X"

Output:

Timestamped note saved to session memory

💡 Example

/note "Need to explore Y theory further"

/remember <text>Storage

Save to Persistent Memory (survives compaction)

Usage:

/remember "Critical insight about methodology"

Output:

Permanent note saved to project memory

💡 Example

/remember "Sample size calculation: G*Power with f² = 0.15"

/diverga:memory archive [STAGE]Archive

Archive completed stage to baseline

Usage:

/diverga:memory archive A1

Output:

Stage moved to .research/baselines/

💡 Example

Locks completed work and creates immutable record

/diverga:memory clearMaintenance

Clear session memory (keeps project memory)

Usage:

/diverga:memory clear [--session|--notes]

Output:

Confirmation of cleared memory

💡 Example

Use --session to only clear current session, --notes for research notes

/diverga:memory refreshMaintenance

Reload memory from files

Usage:

/diverga:memory refresh

Output:

Memory refreshed from disk

💡 Example

Use after manual edits to .research/ files

/diverga:memory exportArchive

Export memory as markdown report

Usage:

/diverga:memory export [--format markdown|json]

Output:

Formatted memory report

💡 Example

Creates audit-ready documentation for methodology section

/diverga:memory migrateMaintenance

Migrate from v6.8 to v7.0 memory structure

Usage:

/diverga:memory migrate

Output:

Migration status and backup location

💡 Example

Only needed once when upgrading from v6.8

Usage Examples

Common workflows using memory commands:

Starting a new research session

/diverga:memory status → Check current project state

/diverga:memory context → Review previous decisions

Continue work with full context loaded

Outcome:

Seamless continuation without re-explaining

Recording important insights

/note "Unexpected correlation between X and Y" → Quick note

/remember "Key methodological decision: Use SEM instead of regression" → Permanent record

/diverga:memory decision add → Log formal decision with rationale

Outcome:

Multi-layered memory capture for different purposes

Completing a research stage

/diverga:memory decision list --stage A1 → Review stage decisions

/diverga:memory archive A1 → Lock completed work

/diverga:memory export --format markdown → Generate documentation

Outcome:

Stage archived with audit trail for manuscript

Troubleshooting memory issues

/diverga:memory status → Check memory health

/diverga:memory refresh → Reload from disk

/diverga:memory clear --session → Clear corrupted session data

Outcome:

Memory system restored to clean state

Command Flags

Optional flags to modify command behavior:

--detailed

Show verbose output with full decision rationale

Applies to: context

--stage <ID>

Filter results by agent stage (e.g., A1, B2)

Applies to: decision list

--format <type>

Output format: markdown, json, yaml

Applies to: export

--session

Only clear session memory, keep project memory

Applies to: clear

--notes

Only clear research notes, keep decisions

Applies to: clear

--force

Skip confirmation prompts

Applies to: clear, archive

Best Practices

Recommendations for effective memory management:

Use /note for ephemeral insights

Quick observations that may not be relevant long-term (auto-pruned after 7 days)

Use /remember for critical decisions

Methodological choices, key findings, and important constraints that must persist

Archive stages when complete

Create immutable records of completed work with /diverga:memory archive

Export before major changes

Generate markdown reports as backup before restructuring research

Check status regularly

Use /diverga:memory status to monitor memory health and loaded contexts

Memory Storage

Where different memory types are stored:

.research/project-state.yaml

Project context, research question, paradigm

.research/decision-log.yaml

All checkpoint decisions with timestamps

.research/sessions/

Session-specific memory (working notes, /note commands)

.research/baselines/

Archived completed stages (immutable)

.research/preferences.yaml

Tool preferences, output formats

.research/checkpoints.yaml

Checkpoint states and progress

Master Memory Management

Explore advanced memory features and integration patterns.

Memory Types Memory API Checkpoints