maojindao55/freebuddy
GitHub: maojindao55/freebuddy
一款桌面端本地 CLI AI 编程工具的统一工作台,支持多 agent 并行运行与团队协作编排。
Stars: 103 | Forks: 8
# FreeBuddy
**专为本地 coding agent 打造的桌面工作台。** ⚡
在一个界面中并排使用 Codex、ClaudeCode、OpenCode、Cursor、Kimi、Qoder 和 CodeBuddy —— 每个 agent 在各自的 workspace 中运行,所有任务集中在一处跟踪。支持两种模式:
* **普通模式 (Normal Mode)**

* **团队执行模式 (Team Execution Mode,多 Agent 协作)**

### [⬇️ 下载 FreeBuddy](https://github.com/maojindao55/freebuddy/releases/latest)
## 功能
| 功能 | 描述 | 演示 |
|---------|-------------|------|
| **多 Agent 支持** | 自动检测本地已安装的 agent |  |
| **BYOK 支持** | Codex 和 ClaudeCode 支持 BYOK —— 使用第三方或代理 API |  |
| **Codex 用量卡片** | 实时查看 Codex 使用情况和速率限制重置时间。无需重新登录即可热切换账号。 |  |
### 🎬 工作流团队
通过团队模板编排多 agent 工作流。运行 Codex 负责实现,ClaudeCode 负责审查,Kimi 负责测试 —— 全部并行执行。
https://github.com/user-attachments/assets/9665bf24-9150-4ffa-b571-10eece2d2062
### 📰 FeedRSS 卡片
在等待 agent 执行完成时,随时了解最新动态。
https://github.com/user-attachments/assets/380965e3-d4eb-4ad1-bb0d-ded33c5272e9
### 💥 代码鞭策
感到抓狂?狠狠“鞭策”一下你的 agent —— 既能加快速度,又能缓解压力。
https://github.com/user-attachments/assets/8bab605f-6f1b-4e53-a520-c3f5a6645ace
## 内置 Agent
FreeBuddy 兼容**所有基于 CLI 的 AI 编程工具** —— 只要能在终端中运行,就能在 FreeBuddy 中运行。
打开 **Settings → Coding Agents** 来:
- ✅ 检查已安装的 runtime
- 📥 运行推荐的安装命令
- ⚙️ 自定义二进制文件路径、模型和附加参数
- 🌐 配置环境变量
- 🎨 选择 agent 头像
## 安装说明
### 桌面端 (macOS / Windows / Linux)
**快速下载:** [FreeBuddy Releases](https://github.com/maojindao55/freebuddy/releases/latest)
| 平台 | 下载 | 包管理器 |
|----------|---------|----------------|
| **macOS (Apple Silicon)** | `.dmg` | `brew install --cask maojindao55/freebuddy/freebuddy` |
| **macOS (Intel)** | `.dmg` | - |
| **Windows** | `.exe` 安装程序 | - |
| **Ubuntu / Debian (x64)** | `.deb` | `sudo apt install ./FreeBuddy_Ubuntu_x64-.deb` |
| **Linux (x64)** | `.AppImage` | `chmod +x FreeBuddy_Linux_x64-.AppImage` |
AppImage 使用静态 runtime,无需安装 FUSE 2 即可在当前的 Ubuntu 版本上运行。
### 从源码构建
前置条件:Node.js 18+,npm 9+
```
# 克隆 repository
git clone https://github.com/maojindao55/freebuddy.git
cd freebuddy
# 安装 dependencies
npm install
# 以开发模式运行
npm run dev
# Production build
npm run build
npm run start
```
在推送分支或创建 pull request 之前,请验证存储的
GitHub CLI 登录状态以及真实的 API 访问权限:
```
npm run github:preflight
```
此检查绝不会打印 token 值,也不会创建新的 OAuth token。如果检查失败,
请按照显示的恢复说明操作,然后再次运行检查。在 Codex sandbox 中,
在开始新登录之前,请先使用系统权限验证一次,
因为 sandbox 可能无法访问 macOS keychain 或网络。
## License
FreeBuddy 采用 [MIT License](LICENSE) 授权。
Codex
ClaudeCode
OpenCode
Cursor
Kimi
Qoder
CodeBuddy
+ any CLI agent
安装命令
| Agent | 命令 | 安装方式 | 状态 | |--------|---------|--------|--------| | **Codex** | `codex-acp` | `npm install -g --force @agentclientprotocol/codex-acp` | ✅ | | **ClaudeCode** | `claude-agent-acp` | `npm install -g @agentclientprotocol/claude-agent-acp` | ✅ | | **OpenCode** | `opencode` | `npm install -g opencode-ai` | ✅ | | **Cursor** | `cursor-agent` | `curl https://cursor.com/install -fsS \| bash` | ✅ | | **Kimi** | `kimi` | `curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash` | ✅ | | **Qoder** | `qodercli` | `curl -fsSL https://qoder.com/install \| bash` | ✅ | | **CodeBuddy** | `codebuddy` | `npm install -g @tencent-ai/codebuddy-code` | 🆕 |由 maojindao55 用 ❤️ 打造
标签:AI编程助手, MITM代理, SOC Prime, 多智能体协作, 开发工具, 效率工具, 暗色界面, 桌面应用, 自动化攻击
