Engram

Native Swift MCP helper + macOS App：聚合 14 个默认启用来源 + 3 个归档默认关闭来源的 AI 编程助手历史会话，实现跨工具上下文共享、关键词搜索和项目迁移。

在 Codex 里做了半天，切到 Claude Code 继续时，AI 不需要你手动解释之前做了什么——它可以直接调用 get_context 查询你的历史。

Current product state (2026-07-15): shipped runtime is the native Swift macOS app + bundled Swift MCP helper. The active MCP surface has 27 tools. The App UI is intentionally keyword-only; service and MCP expose availability-gated semantic/hybrid search when compatible embeddings exist. Session ingestion defaults to 14 active sources plus 3 archived default-off sources. docs/TODO.md now carries one selected implementation-ready delivery: establish a public macOS release baseline above the current public v1.0.3 before new feature work. docs/followups.md has no open implementation-ready engineering follow-ups, and docs/roadmap.md keeps 12 other product decisions visible rather than reporting them as implemented. Exact-source dual-replica archive v2 remains default-off for fresh installs but is operator-enabled on the current deployment; its finite eligible backlog and two-site recovery closeout completed on 2026-07-15; 3 conditional archive-v2 boundaries remain outside implementation-ready work.

┌─────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐
│  Codex  │ │Claude Code│ │Gemini CLI│ │  Cursor  │ │ Cline …│
│ sessions│ │ projects  │ │   tmp    │ │  vscdb   │ │  tasks  │
└────┬────┘ └─────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬────┘
     └────────────┴──────┬─────┴─────────────┴────────────┘
                         ▼
              ┌──────────────────────┐
              │       engram         │
              │  Swift MCP + App UI  │
              │    ~/.engram/        │
              │    index.sqlite      │
              └──────────┬───────────┘
                    ┌────┴────┐
                    ▼         ▼
                MCP Tools   macOS App
              (AI 调用)   (桌面 UI)

目录

• 支持的工具
• 适配器与显示一致性
• 快速上手
• 注册为 MCP Server
• macOS App
• MCP Tools 参考
• 搜索现状
• 项目别名
• 配置
• 添加新适配器
• 数据存储与隐私
• 开发

支持的工具

工具	日志路径	状态
Codex CLI	~/.codex/sessions/	✅ 完整支持
Claude Code	~/.claude/projects/	✅ 完整支持
Gemini CLI	~/.gemini/tmp/	✅ 完整支持
Antigravity	CLI brain ~/.gemini/antigravity-cli/brain/ + legacy cache when present	✅ 完整支持
Windsurf	~/.engram/cache/windsurf cache only; live gRPC sync is disabled	⚠️ cache-only
Cursor	~/Library/Application Support/Cursor/…/state.vscdb	✅ 完整支持
VS Code Copilot	~/Library/Application Support/Code/…/chatSessions/	✅ 完整支持
GitHub Copilot	~/.copilot/session-state/<uuid>/events.jsonl	✅ 完整支持
iflow	~/.iflow/projects/	归档默认关闭，可在 Sources > Archived 启用
Qwen Code	~/.qwen/projects/	✅ 完整支持
Qoder	~/.qoder/projects/	✅ 完整支持
OpenCode	~/.local/share/opencode/opencode.db	✅ 完整支持
Kimi	~/.kimi/sessions/	✅ 完整支持
MiniMax	Claude Code-derived sessions under ~/.claude/projects/	✅ 完整支持
Lobster AI	Claude Code-derived sessions under ~/.claude/projects/	归档默认关闭，可在 Sources > Archived 启用
Command Code	~/.commandcode/projects/	✅ 完整支持
Cline	~/.cline/data/tasks/	归档默认关闭，可在 Sources > Archived 启用

适配器与显示一致性

Engram 的产品解析路径在 Swift 侧：macos/Shared/EngramCore/Adapters/Sources/ 负责读取各工具原始日志，macos/EngramCoreWrite/Indexing/ 负责写入索引库。TypeScript 适配器保留为 dev/reference/fixture too