Engram

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

Download the latest release · v1.0.5 release notes · macOS 14+ · Universal Apple Silicon / Intel

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

Current release (2026-08-02): v1.0.5 is the latest public stable release. It ships a Developer ID-signed and notarized universal macOS app with the bundled Swift service, CLI, and MCP helper. The active MCP surface has 27 tools; the App UI is intentionally keyword-only, while the 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.

┌─────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐
│  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
• Claude Code 插件
• 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	✅ 完整支持
Devin Desktop（原 Windsurf）	legacy ~/.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 CLI	~/.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 tooling，用于生成和校验 fixture parity。