Tages

AI 编码代理的团队记忆库。

你的 AI 代理在会话之间会遗忘一切。每一个决策都需要重新辩论。每一项规范都需要重新解释。每一个过去的错误都会被下一个接触同一代码的代理重复犯下。

个人记忆工具只能修补症状：存储一些事实，稍后再检索。这对于记得自己存储了什么的独立开发者来说有效。但当团队使用 AI 进行交付时，这种方式就会失效——当三名开发者在同一个代码库上使用代理时，当入职培训需要传递机构知识时，当错误的记忆因为无人审计而在重构后幸存时。

记忆不是存储。它是一种团队实践。

Tages 将代码库记忆视为一种托管工件：结构化类型、质量评分、审计追踪，以及将模糊笔记重写为指令性代理提示的“锐化”过程。一名开发者的架构决策会成为所有代理的上下文。错误的记忆会在误导下一次会话之前被标记并纠正。

使用一条命令在 60 秒内启动。当你的工作流需要时，添加团队功能。

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

为什么选择 Tages？

它能记住什么

源代码告诉代理存在什么。Tages 告诉它们为什么要这样构建、如何使用它以及不要做什么。

此外还有：实体、执行、操作、环境、偏好（共 11 种类型）。

工作原理

1. 安装 — tages init 连接到你的项目，或者安装 Claude Code 插件以实现零配置设置

2. 记忆 — 通过 git hooks 手动存储决策和规范，或通过导入 CLAUDE.md 存储

3. 回溯 — 每个会话都能在 10 毫秒内从本地 SQLite 缓存中获取完整的项目上下文

零配置自动检测

当作为 Claude Code 插件或 MCP 服务器运行时，Tages 会自动检测你所在的当前项目：

1. .tages/config.json — 显式标记文件 (由 tages link 创建)

2. Git 远程仓库 — 将仓库名称与已注册项目匹配

3. 目录名称 — 将文件夹名称与已注册项目别名匹配

4. 自动创建 — 如果已认证，则自动创建新的云项目；否则使用仅本地模式

无需为每个目录运行 tages init。使用 tages link [slug] 将目录显式绑定到项目。

Claude Code 插件

将 Tages 安装为 Claude Code 插件以实现自动会话记忆：

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

兼容性

Claude Code, Cursor, Codex, Gemini — 任何支持 MCP 的工具。

功能特性

• 56 个 MCP 工具 — 记忆、回溯、审计、锐化、导入、联邦、分析等

• 52 个 CLI 命令 — 从终端进行完全控制

• Web 仪表板 — 使用深色模式 UI 浏览、搜索和编辑记忆

• 自动索引 — Git hooks 通过 Ollama 或 Claude Haiku 从提交中提取决策

• 导入 — 从现有的 CLAUDE.md、ARCHITECTURE.md 或 JSON 文件中植入数据

• tages brief — 为系统提示词注入生成缓存的上下文文档

• tages audit — 对你的记忆覆盖率进行评分并获取改进建议

• tages sharpen — 将记忆重写为指令形式，以便代理更好地理解

• 本地优先 — SQLite 缓存实现 10 毫秒内查询，支持离线工作

• 混合搜索 — pg_trgm 三元组匹配 + pgvector 语义搜索

• 团队共享 — 多名开发者共享同一个代码库记忆 (专业版)

基准测试

在五项正面基准测试中，拥有 Tages 上下文的代理得分高达 9.1/10，而没有上下文的仅为 2.8/10 — 质量差异从简单任务上的 +1.0 扩展到复杂任务上的 +6.3。最大的提升在于规范合规性、集成连线和陷阱规避。没有记忆的代理持续创建无法连接到现有子系统的孤立代码。

设置指南

• 快速入门

• Claude Code

• Cursor

• Codex

• Gemini

• GitHub Actions

• 自托管

架构

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)

安全性

• 静态加密 — 记忆值使用 AES-256-GCM 加密 (可选)

• RBAC — 所有者/管理员可写，成员只读

• 行级安全性 — 所有表在数据库层强制执行项目成员资格

• 认证 — Supabase Auth + GitHub OAuth；API 令牌经过 SHA-256 哈希处理并带有过期时间

• 密钥检测 — 存储前扫描记忆中的 API 密钥、凭据和个人身份信息 (PII)

• 审计日志 — 跟踪认证事件、导出和令牌验证

请参阅 SECURITY.md 了解我们的完整安全策略和负责任的披露流程。 请参阅 PRIVACY.md 了解我们的隐私政策。

定价

贡献

请参阅 CONTRIBUTING.md 了解开发设置和指南。

许可证

MIT

命名由来

Tages — 伊特鲁里亚神话中的神童，他从大地的一道犁沟中出现，向抄写员口述了神圣的知识后消失。这些知识在源头消失后依然长存。