Documentation · Quickstart

Connect your desktop & mobile agents in 3 minutes

Use Memware Cloud for zero-key cross-device sync (including official Claude & ChatGPT mobile apps), or run the air-gapped Local CLI binary with your own API key.

Option A · Memware Cloud + Remote MCP (Recommended)

Zero LLM Keys Needed · Works on Mobile

1. Sign in to the Memware Console to generate your mw_live_... token. 2. Add the Remote MCP endpoint to Claude Code, Cursor, or claude.ai Connectors:

# Register Remote MCP in Claude Code
claude mcp add --transport http memware https://mcp.aiware.life/mcp \
  --header "Authorization: Bearer mw_live_your_token_here"

# Authenticate local desktop Stop Hooks (Claude Code / Codex / Antigravity)
npx -y memware@latest login

Option B · Memware Local Binary (100% On-Device SQLite · BYOK)

Free up to 200 memories · Offline Ed25519 License

Store everything under ~/.memware/ using your own OpenAI-compatible chat and embedding endpoints. Unlock unlimited local capacity anytime with a one-time Local Lifetime key:

# Optional: Unlock unlimited local memories offline (zero network calls during hooks)
npx -y memware@latest activate MW1.eyJ2IjoxLCJsaWQiOiJsaWNf...

# Register local stdio MCP server in Claude Code
claude mcp add memware -e MEMWARE_API_KEY="$OPENAI_API_KEY" \
  -- npx -y memware@latest serve

The 14 Standard MCP Tools

memory_status
Inspect runtime boundary, tenant status, and model origin health.
memory_warmup
Idempotently warm up the bound tenant profile at session start.
memory_get_context
Budgeted context recall (profile + active threads + semantic matches).
memory_profile
Read structured profile preferences and significant facts with stable IDs.
memory_remember
Explicitly set or overwrite a preference key in place.
memory_threads
List active unfinished task threads ordered newest first.
memory_resume
Cross-agent handoff briefing with last agent provenance & next step.
memory_process
Extract and store durable facts from a completed conversation turn.
memory_search
Semantic + lexical hybrid search across stored memories and clusters.
memory_list
Paginate stored memory records newest first.
memory_update
Update one memory record in place and re-index vectors.
memory_delete
Tombstone a single memory record and its relation projections.
memory_archive
Archive stale low-activity memory clusters.
memory_reset
Atomically wipe all SQLite tables, vectors, and audit files for the tenant.