TheDartsCo/orbit

Orbit

你的编码代理历史记录分散在各个工具中。Orbit 将它们集中在一处。

安装 ·
支持的代理 ·
贡献

Orbit 是一款面向 AI 编码代理的原生会话浏览器。它会找到已存储在你电脑上的会话历史记录，将其规范化为一个本地索引，并为你提供一种快速的方式来搜索、筛选、阅读和恢复过去的工作。

Orbit 的发布版本以 macOS 为先，同时对 Claude Code、Codex、Cursor 和 OpenCode 提供实验性的 Windows 会话发现功能以及本地 Linux 开发支持。AppImage 生成已在当前 Ubuntu 开发机器上本地验证，但尚未声称支持更广泛的 Linux 发布版本。

为什么选择 Orbit

编码代理很有用，但它们的历史记录是碎片化的。一次有用的调试会话可能在 Claude Code 中，昨天的实现可能在 Codex 中，而你需要的那条命令可能埋在 Warp 里。

Orbit 让这些历史记录变得可用：

- 搜索会话标题、消息、工具调用、输入和输出
- 按代理、项目、模型、分支或日期筛选
- 阅读长篇对话记录，而无需将整个对话加载到 UI 中
- 查看活动会话和索引状态
- 在你偏好的终端中恢复受支持的会话
- 在仪表板中查看模型使用统计和会话时间线
- 将所有内容保留在本地

Orbit 读取本地会话文件，并将其索引存储在本地 SQLite 数据库中。它不会上传你的对话记录。

安装

下载

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

Orbit 尚未经过公证。首次启动时，macOS 可能会要求你右键点击应用并选择打开。

从源代码构建

你需要 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 桌面上从源代码构建和运行。本地 AppImage 生成可在当前 Ubuntu 开发机器上进行，但已发布的 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 的索引。你的原始 agent 会话保持不变，可以重新建立索引。

平台状态

- macOS 是主要的开发和发布平台。
- Windows 适配器发现功能已实现并通过单元测试，但仍需要原生 Windows 构建和运行时验证。
- Linux 支持使用 Claude Code、Codex、Cursor、Grok、Kilo Code、OpenCode 和 ZCode 发现功能进行本地开发。本地 AppImage 生成仅在当前 Ubuntu 开发机器上验证过。
- App 包尚未签名或公证。
- 当 agent 供应商更新其工具时，会话格式可能会发生变化。
- Orbit 在手动重新索引时刷新会话；实时文件监视尚未启用。
- 在适配器支持恢复的 macOS 和 Linux 上支持自动恢复启动。Windows 目前使用可复制的会话详情。

开发

npm install
npm run tauri dev

有用的检查：

npm run build
cd src-tauri && cargo test

在更改适配器或提交拉取请求之前，请参阅 CONTRIBUTING.md。

许可证

Orbit 在 MIT 许可证 下提供。