会话浏览器 TheDartsCo/orbit

Orbit

你的编码智能体历史散落在各个工具里。Orbit 把它归到一处。

安装 ·支持的智能体 ·参与贡献

Orbit 是给 AI 编码智能体用的原生会话浏览器。它找出你电脑上已经存着的会话历史，整理成一份本地索引，让你能快速搜索、筛选、阅读，并继续之前的工作。

发布版本以 macOS 优先，同时提供实验性的 Windows 会话发现能力，以及面向 Claude Code、Codex、Cursor 和 OpenCode 的本地 Linux 开发支持。AppImage 生成已在当前 Ubuntu 开发机上本地验证通过，但尚未宣称支持更广泛的 Linux 发行版。

为什么选 Orbit

编码智能体很好用，但历史记录太零散。一次有用的调试会话可能在 Claude Code 里，昨天的实现可能在 Codex 里，你要找的命令可能埋在 Warp 里。

Orbit 让这些历史变得可用：

- 搜索会话标题、消息、工具调用、输入和输出
- 按智能体、项目、模型、分支或日期筛选
- 阅读长对话记录，不必把整段会话加载进界面
- 查看活跃会话和索引状态
- 在你惯用的终端里继续受支持的会话
- 在仪表盘里查看模型用量统计和会话时间线
- 一切数据都留在本地

Orbit 读取本地会话文件，把索引存进本地 SQLite 数据库。它不会上传你的对话记录。

安装

下载

从 GitHub Releases 下载最新的 macOS 版本。

Orbit 尚未公证。首次启动时，macOS 可能要求你右键点击应用，然后选择 Open。

从源码构建

你需要 Node.js 18 或更高版本、Rust，以及对应平台的 Tauri 前置依赖。

在 Ubuntu/Debian 上，先安装 Tauri 的 Linux 开发依赖：

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
build-essential \
curl \
wget \
file \
libxdo-dev \
libssl-dev \
libayatana-appindicator3-dev \
librsvg2-dev

git clone https://github.com/TheDartsCo/orbit.git
cd orbit
npm install
npm run tauri build

打包好的应用输出到 src-tauri/target/release/bundle/。

如果只想在 Ubuntu 上构建本地 Linux AppImage：

npm run build:linux:appimage

AppImage 输出到：

src-tauri/target/release/bundle/appimage/

本地运行：

chmod +x src-tauri/target/release/bundle/appimage/.AppImage
./src-tauri/target/release/bundle/appimage/.AppImage
这个 AppImage 只在当前 Ubuntu 开发机上验证过。可移植的 Linux 发行版应该基于更旧的受支持 Linux 基线来构建。

使用 Orbit

1. 打开 Orbit。
2. 点击左下角的刷新按钮，为本地会话建立索引。
3. 搜索或筛选会话列表。
4. 选中会话，阅读它的对话记录。
5. 源智能体支持时，使用 Resume。

Orbit 会自动检测已安装的智能体。它绝不会创建或修改这些智能体的源会话文件。

支持的智能体

| 智能体 | 对话记录 | macOS 发现 | macOS 恢复 | Windows 发现 | Windows 恢复 | Linux 本地开发 |
| Antigravity | ✅ | ✅ | 不可用 | 🧪 | 📋 复制命令 | 计划中 |
| Claude Code | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | ✅ 启动 |
| Codex | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | ✅ 启动 |
| Cursor | ✅ | ✅ | 打开项目 | 🧪 | 📋 复制命令 | ✅ 打开项目 |
| DeepSeek Harness | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | ✅ 启动 |
| GitHub Copilot CLI | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | 计划中 |
| Grok | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | ✅ 启动 |
| JetBrains AI | ✅ | ✅ | 不可用 | 🧪 | 📋 会话 ID | 计划中 |
| Kilo Code | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | ✅ 启动 |
| OpenCode | ✅ | ✅ | ✅ 启动 | 🧪 | 📋 复制命令 | ✅ 启动 |
| Qoder | ✅ | ✅ | 打开 Qoder | 🧪 | 📋 复制命令 | 计划中 |
| Warp | ✅ | ✅ | 打开 Warp | 🧪 | 📋 复制命令 | 计划中 |
| ZCode | ✅ | ✅ | 不可用 | 🧪 | 📋 复制命令 | 不可用 |

图例： ✅ 支持 · 🧪 已实现并通过单元测试，原生 Windows 验证待完成 · 📋 在可复制的 Windows 对话框中显示

在 Windows 上，Orbit 会发现并解析本地会话，但还不会自动启动恢复命令。点击 Resume 会显示会话 ID 和可用命令，方便你复制。

Linux 本地开发支持是指：装好 Tauri 依赖后，可以在 Linux 桌面上从源码构建并运行应用。当前 Ubuntu 开发机支持本地生成 AppImage，但正式发布的 Linux 发行包仍不在 v0.1 支持范围内。

智能体的存储格式属于私有实现细节，可能随时变化。如果某次更新弄坏了适配器，请提 issue，附上智能体版本和受影响会话结构的脱敏示例。

工作原理

Orbit 是 Tauri v2 桌面应用，前端用 React，后端用 Rust。

每个智能体都有一个小型 Rust 适配器，负责检测、会话发现、解析和恢复命令。索引器把这些会话规范化后写入 SQLite，用解析器版本和文件元数据哈希跳过未变化的文件，并在每次完整扫描后删除过期条目。

前端通过 Tauri 命令与后端通信。会话列表和对话记录列表都做了虚拟化，因此历史记录再大也能保持流畅。
本地数据库放在平台数据目录里：

macOS: ~/Library/Application Support/orbit/orbit.db
Windows: %APPDATA%\orbit\orbit.db
Linux: ~/.local/share/orbit/orbit.db

删掉这个数据库只会清掉 Orbit 的索引。你原来的智能体会话不受影响，可以重新建立索引。

平台支持情况

- macOS 是主要开发和发布平台。
- Windows 适配器发现逻辑已经实现，也有单元测试，但还需要在原生 Windows 上做构建和运行时验证。
- Linux 支持本地开发，可发现 Claude Code、Codex、Cursor、Grok、Kilo Code、OpenCode 和 ZCode。本地 AppImage 生成只在当前这台 Ubuntu 开发机上验证过。
- App 包目前还没有签名，也没有公证。
- 智能体厂商更新工具时，会话格式可能跟着变。
- Orbit 只在手动重建索引时刷新会话；实时文件监听还没启用。
- macOS 和 Linux 上，适配器支持恢复的话就能自动启动恢复。Windows 暂时只能复制会话详情。

开发

npm install
npm run tauri dev

常用检查：

npm run build
cd src-tauri && cargo test

改适配器或提 pull request 之前，先看 CONTRIBUTING.md。

许可证

Orbit 基于 MIT License 发布。