Tages

Team memory for AI coding agents.

Your AI agents forget everything between sessions. Every decision re-litigated. Every convention re-explained. Every past mistake repeated by the next agent that touches the same code.

Personal memory tools patch the symptom: store some facts, retrieve them later. That works for solo developers who remember what they stored. It breaks down when teams ship with AI — when three developers are using agents on the same codebase, when onboarding requires transferring institutional knowledge, when the wrong memory survives a refactor because no one audited it.

Memory isn't storage. It's a team practice.

Tages treats codebase memory as a managed artifact: structured types, quality scoring, audit trails, sharpen passes that rewrite vague notes into imperative agent instructions. One developer's architecture decision becomes every agent's context. A bad memory gets flagged and corrected before it misleads the next session.

Start in under 60 seconds with one command. Add team features when your workflow demands them.

claude mcp add tages -- npx -y @tages/server

Why Tages?

What It Remembers

Source code tells agents what exists. Tages tells them why it was built, how to work with it, and what not to do.

Plus: entity, execution, operational, environment, preference (11 types total).

How It Works

1. Install — tages init connects to your project, or install the Claude Code plugin for zero-config setup

2. Remember — Store decisions and conventions manually, via git hooks, or by importing CLAUDE.md

3. Recall — Every session gets full project context in <10ms from local SQLite cache

Zero-Config Auto-Detection

When running as a Claude Code plugin or MCP server, Tages automatically detects which project you're in:

1. .tages/config.json — explicit marker file (created by tages link)

2. Git remote — matches the repo name against registered projects

3. Directory name — matches the folder name against registered project slugs

4. Auto-create — if authenticated, creates a new cloud project automatically; otherwise uses local-only mode

No tages init required per directory. Use tages link [slug] to explicitly bind a directory to a project.

Claude Code Plugin

Install Tages as a Claude Code plugin for automatic session memory:

/plugin https://github.com/ryantlee25-droid/tages

Works With

Claude Code, Cursor, Codex, Gemini — anything that speaks MCP.

Features

• 56 MCP tools — remember, recall, audit, sharpen, import, federation, analytics, and more

• 52 CLI commands — full control from the terminal

• Web dashboard — browse, search, and edit memories with dark-mode UI

• Auto-indexing — git hooks extract decisions from commits via Ollama or Claude Haiku

• Import — seed from existing CLAUDE.md, ARCHITECTURE.md, or JSON files

• tages brief — generate a cached context document for system prompt injection

• tages audit — score your memory coverage and get suggestions for improvement

• tages sharpen — rewrite memories into imperative form for better agent consumption

• Local-first — SQLite cache for sub-10ms queries, works offline

• Hybrid search — pg_trgm trigram matching + pgvector semantic search

• Team sharing — multiple developers share one codebase memory (Pro)

Benchmarks

In five head-to-head benchmarks, agents with Tages context scored up to 9.1/10 vs 2.8/10 without — quality deltas scaling from +1.0 on simple tasks to +6.3 on complex ones. The biggest gains were in convention compliance, integration wiring, and gotcha avoidance. Agents without memory consistently created orphaned code that didn't wire into existing subsystems.

Setup Guides

• Quickstart

• Claude Code

• Cursor

• Codex

• Gemini

• GitHub Actions

• Self-Hosting

Architecture

packages/
  server/     MCP server (56 tools, stdio transport, 445 tests)
  cli/        CLI (52 commands, npm global install, 76 tests)
  shared/     TypeScript types + Supabase client
apps/
  dashboard/  Next.js 16, Supabase Auth, Tailwind, shadcn/ui
supabase/
  migrations/ 42 migrations (tables, RLS, pgvector, RBAC, encryption)

Security

• Encryption at rest — AES-256-GCM for memory values (opt-in)

• RBAC — Owner/admin write, member read-only

• Row Level Security — All tables enforce project membership at the database layer

• Auth — Supabase Auth + GitHub OAuth; API tokens SHA-256 hashed with expiration

• Secret detection — Memories scanned for API keys, credentials, PII before storage

• Audit logging — Auth events, exports, and token validation tracked

See SECURITY.md for our full security policy and responsible disclosure process. See PRIVACY.md for our privacy policy.

Pricing

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT

Named After

Tages — the Etruscan divine child who appeared from a furrow in the earth and dictated sacred knowledge to scribes before vanishing. The knowledge persisted long after the source was gone.