cockpit-tools README

The project's README from github.com/jlcodes99/cockpit-tools. As one markdown file: README.md.

Cockpit Tools

English · Portuguese (BR) · 简体中文

GitHub stars GitHub downloads GitHub release GitHub issues

一款通用的 AI IDE 账号管理工具,目前支持 Antigravity IDE、Codex、GitHub Copilot、Windsurf、Kiro、Cursor、Grok CLI、CodeBuddy、CodeBuddy CN、Qoder、Trae、TRAE SOLO、Trae CN、TRAE SOLO CN、Zed 和 ZCode,并支持多账号多实例并行运行。

本工具旨在帮助用户高效管理多个 AI IDE 账号,支持一键切换、配额监控、自动唤醒与应用多开并行运行,助您充分利用不同账号的资源。

功能:一键切号 · 多账号管理 · 应用多开 · 配额监控 · 唤醒任务 · 插件联动 · GitHub Copilot 管理 · Windsurf 管理 · Kiro 管理 · Cursor 管理 · Grok CLI 管理 · CodeBuddy 管理 · CodeBuddy CN 管理 · Qoder 管理 · Trae 套件管理 · Zed 管理 · ZCode 管理

语言:支持 18 种语言

🇺🇸 English · 🇨🇳 简体中文 · 繁體中文 · 🇯🇵 日本語 · 🇩🇪 Deutsch · 🇪🇸 Español · 🇫🇷 Français · 🇮🇹 Italiano · 🇰🇷 한국어 · 🇧🇷 Português · 🇷🇺 Русский · 🇹🇷 Türkçe · 🇵🇱 Polski · 🇨🇿 Čeština · 🇸🇦 العربية · 🇻🇳 Tiếng Việt · 🇮🇩 Bahasa Indonesia

官方支持平台:macOS、Windows、Linux。


赞助商

APIKEY.FUN APIKEY.FUN 是一家专业的企业级 AI 中转站,致力于为企业和个人开发者提供稳定、高效、低成本的 AI 模型 API 接入服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型,价格低至官方原价的 7%。通过本项目 专属链接 注册,还可享受最高 充值永久 95 折 专属优惠。
APIMart 感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,通过此注册链接注册即可开用。
RoxyBrowser RoxyBrowser(Roxy浏览器) 是面向多账号运营与 AI 自动化场景的指纹浏览器,支持独立浏览器指纹环境、Cookie / 存储隔离、Roxy 原生住宅 IP、团队协作与 API / MCP 自动化能力,适合需要管理 AI 账号矩阵、降低账号关联风险、提升长期使用稳定性的用户。通过 Cockpit 邀请链接 注册或购买,可享受 10% 粉丝折扣。

功能概览

1. 仪表盘 (Dashboard)

全新的可视化仪表盘,为您提供一站式的状态概览:

Dashboard Overview

2. Antigravity IDE 账号管理

Antigravity IDE Accounts

(唤醒任务) Wakeup Tasks

2.1 Antigravity IDE 应用多开

支持同一平台多账号多实例并行运行。比如同时打开两个 Antigravity IDE,分别绑定不同账号,分别处理不同项目,互不影响。

Antigravity IDE Instances

3. Codex 账号管理

Codex Accounts

3.1 Codex 应用多开

Codex 同样支持多账号多实例并行运行。比如同时打开两个 Codex,分别绑定不同账号,分别处理不同项目,互不影响。

Codex Instances

4. GitHub Copilot 账号管理

4.1 GitHub Copilot 应用多开

基于 VS Code 的 Copilot 多实例管理,支持独立配置与生命周期控制。

5. Windsurf 账号管理

5.1 Windsurf 应用多开

支持 Windsurf 多实例管理,支持独立配置与生命周期控制。

6. Kiro 账号管理

6.1 Kiro 应用多开

支持 Kiro 多实例管理,支持独立配置与生命周期控制。

7. Cursor 账号管理

7.1 Cursor 应用多开

支持 Cursor 多实例管理,支持独立配置与生命周期控制。

8. Grok CLI 账号管理

8.1 Grok CLI 多实例

Grok CLI 默认实例通常直接沿用官方 ~/.grok 目录,启动时不设置 GROK_HOME;受管实例使用独立目录。API Key 账号(含第三方接口)为避免被官方 OAuth session 抢占凭据优先级,也始终通过账号专属 GROK_HOME 启动。

9. CodeBuddy 账号管理

8.1 CodeBuddy 应用多开

支持 CodeBuddy 多实例管理,支持独立配置与生命周期控制。

10. CodeBuddy CN 账号管理

9.1 CodeBuddy CN 应用多开

支持 CodeBuddy CN 多实例管理,支持独立配置与生命周期控制。

11. Qoder 账号管理

10.1 Qoder 应用多开

支持 Qoder 多实例管理,支持独立配置与生命周期控制。

12. Trae 账号管理

11.1 Trae 应用多开

支持原 Trae 客户端多实例管理,支持独立配置与生命周期控制。

13. Zed 账号管理

14. ZCode 账号管理

13.1 ZCode 应用多开

支持 ZCode 多实例管理,每个受管实例使用独立的 Electron 用户数据、会话数据和 ZCode 数据目录。

15. 通用设置

Settings


安全性与隐私(简明版)

下面是最关心的几个问题,尽量用直白语言说明:

WebSocket 账号切换 API

request.switch_account 支持明确选择 Antigravity 客户端。未传 runtime_target,或传 "antigravity_ide",保持原有 IDE 切号流程及现有启动/无感双通道设置;不会读取前端选择的客户端。

切换 Antigravity 桌面版及使用同一系统凭据的 agy CLI,可发送:

{"type":"request.switch_account","payload":{"account_id":"<account-id>","request_id":"x","runtime_target":"antigravity","launch_on_switch":false}}

设置项说明(小白版)

如果你只想“能用、稳定、不折腾”,优先按“推荐值”设置即可。

通用设置

设置项 这是做什么的(通俗) 推荐值 什么时候改
显示语言 改界面文字语言 你最熟悉的语言 只在看不懂时改
应用主题 改亮色/暗色外观 跟随系统 长时间夜间使用可改深色
窗口关闭行为 点关闭按钮后的动作 每次询问 想后台常驻选“最小化到托盘”
Antigravity IDE 自动刷新配额 后台定时更新 Antigravity IDE 配额 5~10 分钟 账号多、想更实时可改 2 分钟
Codex 自动刷新配额 后台定时更新 Codex 配额 5~10 分钟 同上
GitHub Copilot 自动刷新配额 后台定时更新 GitHub Copilot 配额 5~10 分钟 同上
Windsurf 自动刷新配额 后台定时更新 Windsurf 配额 5~10 分钟 同上
Kiro 自动刷新配额 后台定时更新 Kiro 配额 5~10 分钟 同上
Cursor 自动刷新配额 后台定时更新 Cursor 配额 5~10 分钟 同上
Grok CLI 自动刷新配额 后台定时刷新 token 并更新配额 5~10 分钟 同上
CodeBuddy 自动刷新配额 后台定时更新 CodeBuddy 配额 5~10 分钟 同上
CodeBuddy CN 自动刷新配额 后台定时更新 CodeBuddy CN 配额 5~10 分钟 同上
Qoder 自动刷新配额 后台定时更新 Qoder 配额 5~10 分钟 同上
Trae 自动刷新配额 后台定时更新 Trae 套件账号配额 5~10 分钟 同上
Zed 自动刷新配额 后台定时更新 Zed 配额 5~10 分钟 同上
数据目录 存账号与配置文件的位置 默认即可 仅用于排查、备份
Antigravity IDE/Codex/VS Code/Windsurf/Kiro/Cursor/Grok CLI/CodeBuddy/CodeBuddy CN/Qoder/Trae/Zed/OpenCode 启动路径 指定应用可执行文件位置 留空(自动检测) 自动检测失败、或你装在自定义路径时
切换 Codex 时自动重启 OpenCode 切换 Codex 后自动同步 OpenCode 账号信息 使用 OpenCode 就开启;不用就关闭 频繁切号且需要 OpenCode 同步时开启

补充说明:

网络服务设置

设置项 这是做什么的(通俗) 推荐值 风险/注意点
WebSocket 服务 给本机插件/客户端实时通信用 不用插件联动就关闭 开启后仍是本机 127.0.0.1 访问
首选端口 WebSocket 监听端口 默认 19528 若端口冲突可改,保存后需重启应用
当前运行端口 实际已使用端口 只读查看 配置端口被占用时会自动回退到其它端口

三套推荐配置(直接抄)

  1. 稳定省心:自动刷新 10 分钟 + WebSocket 关闭(不用插件时)+ 路径保持默认。
  2. 高频切号:自动刷新 2~5 分钟 + 需要联动时开启 WebSocket + OpenCode 联动开启。
  3. 安全优先:WebSocket 关闭 + 不共享用户目录 + 定期清理不再使用的账号。

安装指南 (Installation)

选项 A: 手动下载 (推荐)

前往 GitHub Releases 下载对应系统的安装包:

Windows 便携包解压后直接运行其中的 Cockpit Tools.exe(或同名主程序)。系统需要 Windows 10/11 的 Microsoft Edge WebView2 Runtime;账号和配置仍按当前 Windows 用户目录保存,不会随 ZIP 文件夹自动迁移。

选项 B: Homebrew 安装 (macOS)

需要先安装 Homebrew。

brew tap jlcodes99/cockpit-tools https://github.com/jlcodes99/cockpit-tools
brew install --cask cockpit-tools

如果遇到 macOS “应用已损坏”或无法打开,也可以使用 --no-quarantine 安装:

brew install --cask --no-quarantine cockpit-tools

如果提示已存在应用(例如:already an App at '/Applications/Cockpit Tools.app'),请先删除旧版本再安装:

rm -rf "/Applications/Cockpit Tools.app"
brew install --cask cockpit-tools

或者直接强制覆盖安装:

brew install --cask --force cockpit-tools

🛠️ 常见问题排查 (Troubleshooting)

macOS 提示“应用已损坏,无法打开”?

由于 macOS 的安全机制,非 App Store 下载的应用可能会触发此提示。当前开源发布流程尚未接入 Apple Developer ID 签名和公证,因此部分系统版本会显示更严格的 Gatekeeper 提示。您可以按照以下步骤快速修复:

  1. 命令行修复 (推荐): 打开终端,执行以下命令:

    sudo xattr -rd com.apple.quarantine "/Applications/Cockpit Tools.app"
    

    注意: 如果您修改了应用名称,请在命令中相应调整路径。

  2. 或者: 在“系统设置” -> “隐私与安全性”中点击“仍要打开”。


开发与构建

前置要求

安装依赖

npm install

开发模式

npm run tauri dev

构建产物

npm run tauri build

Star History

Star History Chart


💬 交流群

新建 Telegram 畅聊群:点击加入

微信(个人):

微信联系二维码

☕ 赞助项目

如果不介意,请 ☕ 赞赏支持一下

您的每一份支持都是对开源项目最大的鼓励!无论金额大小,都代表着您对这个项目的认可。


致谢

感谢以上项目作者的开源贡献!如果这些项目对你有帮助,也请给他们点个 ⭐ Star 支持一下!


许可证

本项目默认采用 CC BY-NC-SA 4.0 许可协议(署名-非商业性使用-相同方式共享)。


免责声明

本项目仅供个人学习和研究使用。使用本项目即表示您同意:

项目作者对因使用本项目而产生的任何直接或间接损失不承担责任。

cockpit-tools (jlcodes99/cockpit-tools)

oauth
Searching Database…

What is this?A desktop app that manages multiple accounts for AI coding tools — Antigravity, Codex, GitHub Copilot, Windsurf, Kiro, Cursor, Grok CLI, CodeBuddy, Qoder, Trae, Zed, ZCode and more — with one-click switching, quota monitoring, wake-up tasks and multi-instance running.
Is it a hosted web dashboard, or something I install on my own machine?It is a local desktop GUI app built with Tauri (Rust backend, web UI) with official builds for macOS, Windows and Linux — there is no hosted version.
Do I need to install anything else besides the app itself?The packaged app needs nothing extra except Microsoft Edge WebView2 Runtime on Windows 10/11. Only building from source requires a dev stack: Node.js v18+, npm v9+ and Rust (Tauri runtime).
Why does macOS warn that the app is damaged when I open it?Releases are not signed or notarized with an Apple Developer ID yet, so some macOS versions show a stricter Gatekeeper warning. Run the xattr fix command from the README, or pick Open Anyway in System Settings → Privacy & Security.
How does switching accounts actually work?You import each account once (OAuth, refresh token, JSON or local import, depending on the tool), and switching then rewrites that tool's credentials — no manual logout and login. Many tools can also be relaunched automatically with the new account injected.
What are the wake-up tasks for?They are scheduled jobs that wake the AI model ahead of the quota reset cycle, so an account's quota is already refreshed and ready when you sit down to use it.
Can I run two instances of the same IDE on different accounts?Yes — every supported app can run multi-instance: each copy gets its own user directory, bound account and launch parameters, so two Codex or Antigravity windows can work on separate projects without interfering.
Can I use my Codex subscription through a local API?Yes — Codex gets a local API service powered by the built-in CLIProxyAPI sidecar: Cockpit Tools handles account sync and usage stats while your Base URL and API key workflow stays unchanged. Audio endpoints like /v1/audio/transcriptions are exposed too.
Creator
jlcodes99
Size
396.7 MB
Stars
19K
Age
9mo
Commits · 90 Days