Repository avatar
Other Tools
v0.2.1
active

memware

io.github.HackSing/memware

Shared long-term memory & Stop-hook task handoff across Claude Code, Codex, Cursor, and mobile.

Documentation

Memware MCP

npm version GitHub Release Remote MCP Website

English · 简体中文 · Official Website & Console (aiware.life) · Documentation

One Memory. Every Agent. Always Knows You.

Memware gives Claude Code, Codex, Cursor, Antigravity, and Claude / ChatGPT mobile apps one shared, durable long-term memory of your preferences, facts, and active engineering threads—with automatic Stop-hook capture so persistence never depends on the LLM remembering to call a tool.

Memware Cross-Agent Memory Handoff


Quickstart (Under 2 Minutes)

Option A — Memware Cloud (Remote MCP · Zero Local LLM Keys · Desktop + Mobile Sync)

  1. Sign in at aiware.life/login (GitHub or Google) and copy your mw_live_... token from the console.
  2. Connect Claude Code directly over Streamable HTTP:
claude mcp add --transport http memware https://mcp.aiware.life/mcp \
  --header "Authorization: Bearer mw_live_..."

Or connect via standard mcp.json (Cursor, Windsurf, VS Code, Claude Desktop):

{
  "mcpServers": {
    "memware": {
      "url": "https://mcp.aiware.life/mcp",
      "headers": {
        "Authorization": "Bearer mw_live_..."
      }
    }
  }
}

Want automatic local Stop-hook turn capture synced straight to your Cloud vault (with zero local OpenAI API keys)? Run once:

npx -y memware@latest login mw_live_...

Option B — Memware Local (100% Offline SQLite + Bring Your Own Key)

Run Memware locally on macOS (darwin-arm64), Linux (linux-x64), or Windows (windows-x64) with your own OpenAI-compatible endpoint:

claude mcp add memware -e MEMWARE_API_KEY="sk-..." -- npx -y memware@latest serve

Standard stdio mcp.json configuration:

{
  "mcpServers": {
    "memware": {
      "command": "npx",
      "args": ["-y", "memware@latest", "serve"],
      "env": {
        "MEMWARE_API_KEY": "sk-...",
        "MEMWARE_AGENT_ID": "cursor"
      }
    }
  }
}

Starter Free vs. Local Lifetime: Local mode is free up to 200 active memories (reads, searches, updates, and deletes are never locked). Unlock unlimited local memories offline across 3 personal devices with npx -y memware@latest activate <MW1_LICENSE_KEY> at aiware.life/pricing.


Enable Automatic Turn Capture (Stop Hooks)

Read tools let agents recall context, while Stop hooks capture every completed turn automatically in the background without blocking your terminal:


All 14 MCP Memory Tools

Both https://mcp.aiware.life/mcp and npx -y memware@latest serve expose the exact same 14 MCP tools:

ToolPurpose
memory_statusInspect vault status, active tier, quota usage, and configured model origins.
memory_warmupWarm up and initialize the bound user profile idempotently.
memory_get_contextAssemble budgeted context (profile + active threads + hybrid semantic recall) for a query.
memory_profileRead structured user profile facts, preferences, and standing constraints.
memory_rememberExplicitly set or overwrite a durable user preference (field -> value).
memory_threadsList active unfinished work threads with last-agent provenance and next steps.
memory_processDistill and deduplicate durable facts & thread state from a conversation turn.
memory_searchHybrid dense-vector + lexical search across stored memories.
memory_listPaginate stored memory records newest-first.
memory_updateEdit an existing memory fact, category, or importance score in place.
memory_deleteSoft-delete (tombstone) a specific memory record and remove its vectors.
memory_resumeCross-agent task handoff: generate a ready-to-continue briefing across Claude Code, Codex, and mobile.
memory_archiveArchive stale low-activity memory clusters.
memory_resetCryptographically fenced physical wipe of all memories, vectors, and threads in the vault.

Cloud vs. Local Deployment

FeatureMemware Cloud (aiware.life)Memware Local (npx memware)
SetupZero LLM keys · 1 URL (mcp.aiware.life/mcp)Local single-file binary + BYOK
StorageIsolated Edge Vault + Multilingual Vector Index~/.memware local SQLite + vectors
Multi-Device & MobileYes (Claude iOS/Android, ChatGPT App, Desktop)Single machine
Visual Web ConsoleYes (aiware.life/app/memories)Local CLI / HTTP loopback
PricingFree Starter · Pro $12/mo ($99/yr) · Max $29/moFree up to 200 memories · $49 Founding Lifetime

Downloads & Support

Copyright (c) 2026 Memware (aiware.life). Commercial software — see LICENSE inside distributed packages.

No installation packages available.

Remote