Memory

Arcana's memory system is a persistent, searchable knowledge base that grows with every session. During conversations, Arcana automatically extracts key facts, decisions, and context — storing them in a local SQLite database with full-text search (FTS5). Over time, your memory becomes a rich wiki of your project's architecture, decisions, and conventions.

How It Works

Memory operates in three stages:

1. Extraction — During each session, Arcana identifies and extracts factual statements (e.g., "The API uses JWT tokens with a 24-hour expiry")
2. Storage — Facts are stored in a local SQLite database with FTS5 indexing for fast full-text search
3. Retrieval — At the start of new sessions, relevant facts are automatically retrieved and surfaced to the AI

Searching Memory

You can search your memory at any time using arcana memory search. Results are ranked by relevance using FTS5's built-in ranking.

# Full-text search across all facts
arcana memory search "project architecture"

# List all stored facts (paginated)
arcana memory facts --limit 50

# Filter facts by topic tag
arcana memory facts --topic "api"

# Filter by date range
arcana memory facts --since 2026-06-01 --until 2026-07-01

# View fact details
arcana memory fact <fact-id>

Cloud Sync

Enable cloud sync to share memory across multiple machines. This is useful if you work from different computers and want your knowledge base to follow you. Cloud sync requires an active Pro or Enterprise license.

# Enable cloud sync in config
arcana config set memory.cloudSync true

# Push local facts to the cloud
arcana memory push

# Pull latest facts from the cloud
arcana memory pull

# View sync status
arcana memory sync-status

Cloud sync is bidirectional: push uploads your local changes, while pull downloads facts from other machines. Conflicts are resolved by timestamp (latest wins).

Memory Management

# View memory statistics (total facts, size, last sync)
arcana memory stats

# Clear all local memory
arcana memory clear

# Rebuild the FTS5 search index (if search feels slow)
arcana memory rebuild-index

# Export memory to JSON
arcana memory export --file memory-backup.json

# Import memory from JSON
arcana memory import --file memory-backup.json

Privacy

Memory is stored locally by default. Facts never leave your machine unless you explicitly enable cloud sync. You can review, edit, or delete individual facts at any time.