Skip to main content
Glama

total-agent-memory

Persistent memory for Claude Code, Codex CLI, Cursor, Cline and any MCP client. Local-first. Hits #5 on LoCoMo and 96.2% R@5 on LongMemEval.

npx -y total-agent-memory connect claude-code
# → server installed in ~/.tam, IDE wired, dashboard live at
#   http://127.0.0.1:37737

One command bootstraps a Python virtual env in ~/.tam/, installs the MCP server and registers two background services with your OS:

  • Dashboard — web UI on http://127.0.0.1:37737 (LaunchAgent on macOS, systemd-user unit on Linux, Scheduled Task on Windows). Survives reboot.

  • Reflection — file-watch drain of the reflection queues. Fires whenever the server touches ~/.tam/.reflect-pending (debounce 10s).

Pass --no-services to skip the auto-service install.

Quick start

# Onboard (install + show next steps)
npx -y total-agent-memory

# Or explicit
npx -y total-agent-memory install
npx -y total-agent-memory connect claude-code
npx -y total-agent-memory connect cursor
npx -y total-agent-memory connect codex
npx -y total-agent-memory status

Alias: tam (same binary).

Related MCP server: apex-memory

Commands

Command

What it does

install

Create venv, install Python server, register dashboard + reflection services. Idempotent.

start

Run the MCP server (stdin/stdout).

connect <ide>

Wire an IDE config. claude-code codex cursor cline continue windsurf gemini-cli opencode aider

dashboard <sub>

Manage background services: install, uninstall, start, stop, restart, status, logs, open.

demo

Health-check end-to-end.

status

Print install paths, DB size, service status, dashboard HTTP probe.

doctor

Diagnose Python/uv/git on PATH.

upgrade

Pull the latest server version.

uninstall

Remove ~/.tam and unregister all services (needs --yes).

Options

Flag

Meaning

--server-version 12.3.0

Pin a specific server release.

--source pypi|git

Force install source. Default: PyPI with GitHub fallback.

--memory-dir /path

Override install dir (default ~/.tam).

--no-services

Skip dashboard / reflection auto-install.

--yes

Skip prompts (needed for uninstall).

--no-color

Disable ANSI.

--verbose

Print every shell command.

Requirements

  • Node ≥ 18 (you already have it if you're reading this).

  • Python ≥ 3.11 on PATH. The wrapper will tell you how to install it if missing.

  • Optional: uv — 10× faster installs, auto-detected.

What gets installed

~/.tam/
├── .venv/                   # isolated Python env
│   └── bin/total-agent-memory   # MCP server entry-point
├── logs/
│   ├── dashboard.log
│   └── reflection.log
├── memory.db                # SQLite — your memory lives here
└── .reflect-pending         # touched on every save → triggers reflection

Background services registered with your OS:

OS

Location

macOS

~/Library/LaunchAgents/com.total-agent-memory.{dashboard,reflection}.plist

Linux

~/.config/systemd/user/tam-{dashboard,reflection}.{service,path}

Windows

Task Scheduler — TotalAgentMemory-dashboard (reflection: manual)

Nothing system-wide. Uninstall with tam uninstall --yes (removes services first).

Verify

tam dashboard status
# ● dashboard    running
# ◉ reflection   watching
# ✓ HTTP http://127.0.0.1:37737 → 200

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding agents to maintain persistent, cross-session memory of codebase architecture, naming conventions, and decisions through MCP tools. Eliminates repetitive project re-explanation by automatically injecting stored context into every session with local-first SQLite storage and optional team sharing capabilities.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Persistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.
      24 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides offline-first, persistent memory for AI coding assistants. It captures project decisions and conventions into a local SQLite database and syncs them to tool-specific memory files like CLAUDE.md and AGENTS.md.
      4 npm
      MIT