Tages

Persistent codebase memory for AI coding agents.

Your agents remember everything. Your codebase never gets re-explained.

Tages is an open-source MCP server that gives AI coding agents persistent, cross-session memory about your codebase. Architectural decisions, naming conventions, module boundaries, past mistakes — remembered automatically, injected into every session, across every tool.

Named after Tages, the Etruscan divine child who emerged from a plowed field and dictated all sacred knowledge to scribes before disappearing. Knowledge that surfaces from the ground, gets recorded, and persists.

Works With

• Claude Code
• Cursor
• ChatGPT
• Codex
• Gemini
• Anything that speaks MCP

Quick Start

npm install -g tages
tages init

That's it. Your AI tools now remember your codebase.

How It Works

1. Install — tages init connects to your project and configures your AI tools
2. Remember — Agents store decisions, conventions, and context as they work. Git hooks auto-extract from commits.
3. Recall — Every new session starts with full project context. No re-explanation needed.

CLI Commands

tages init              # Initialize for current project (GitHub OAuth)
tages init --local      # Local-only mode (no cloud sync)
tages remember <key> <value> --type convention  # Store a memory
tages recall <query>    # Fuzzy search memories
tages forget <key>      # Delete a memory
tages status            # Show memory counts and sync status
tages dashboard         # Open web dashboard

MCP Tools

The MCP server exposes 7 tools to AI agents:

Plus 4 resources: memory://project/{id}/conventions, architecture, decisions, entities.

Setup Guides

• Claude Code
• Quickstart

Features

• MCP Server — 7 tools + 4 resources, works with any MCP-compatible agent
• CLI — tages remember, tages recall, tages query, tages import
• Dashboard — Browse, search, edit memories. Dark mode. Real-time updates.
• Auto-indexing — Git hook extracts decisions from commits using local LLM (Ollama) or Claude Haiku
• Import — Seed from existing CLAUDE.md, ARCHITECTURE.md, LESSONS.md files
• Team sharing — Multiple developers share one codebase memory (Pro)
• Local-first — SQLite cache for sub-10ms queries. Works offline.

Pricing

• Free — 1 project, 500 memories, MCP server + CLI (open source, always free)
• Pro ($9/mo) — Unlimited projects + memories, team sharing, auto-indexing
• Self-hosted — Everything free forever, bring your own Supabase

Architecture

packages/
  server/     # MCP server (Node.js, @modelcontextprotocol/sdk)
  cli/        # tages CLI (commander.js, npm global install)
  shared/     # Shared TypeScript types + Supabase client
apps/
  dashboard/  # Next.js 16 + Supabase + Tailwind + shadcn/ui
supabase/
  migrations/ # Postgres schema

Development

pnpm install
pnpm build
pnpm dev        # starts dashboard

Environment Variables

For the dashboard (apps/dashboard/.env.local):

NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key

For the CLI / MCP server (set via tages init or env):

TAGES_SUPABASE_URL=your-supabase-url
TAGES_SUPABASE_ANON_KEY=your-supabase-anon-key
TAGES_PROJECT_ID=your-project-id

Release Notes

2026-04-04 — Week 1: Foundation

• Monorepo scaffold (pnpm workspaces, TypeScript strict)
• Supabase schema: 5 tables, RLS policies, pg_trgm fuzzy search
• MCP server: 7 tools + 4 resources, stdio transport, SQLite cache
• CLI: init, remember, recall, forget, status, dashboard
• Dashboard: GitHub OAuth, project list, memory browser with real-time updates
• Local-only mode for offline/self-hosted usage

License

MIT