all-agent — Gestor de Agentes IA para Linux
mooi-max/all-agent
Instale e configure agentes IA no terminal em uma interface unificada
Ver no GitHubFerramenta TUI em Rust que centraliza instalação, configuração e gerenciamento de múltiplos agentes de IA no terminal Linux (Claude Code, Codex CLI, Gemini, Hermes, etc.). Automatiza detecção de ambiente, criação de API Keys, seleção de modelos e escrita de configurações com backup automático.
Instalação
npx convez-ai mooi-max/all-agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Instalar e atualizar múltiplos agentes IA (Claude, OpenAI, Gemini, DeepSeek) em uma única ferramenta
- Gerenciar API Keys e modelos para diferentes provedores (OpenAI-compatible, Anthropic-compatible, Gemini)
- Automatizar configuração de ambiente Python/Node.js e validação de dependências
- Centralizar backups de configurações antes de aplicar mudanças
Veredito

Ferramenta sólida e bem pensada para quem usa múltiplos agentes IA em Linux; elimina repetição manual de comandos e gerenciamento de arquivos de config. Rust + TUI garantem performance e portabilidade, com workflow intuitivo e segurança (backup automático, chmod 600 em secrets).
README
A tradução para o português deste README ainda está na fila.
all-agent
all-agent 是一个面向 Linux 终端的 AI Agent 快速安装与配置工具。它用 TUI 把环境检查、Agent 安装/更新、API Key 创建、模型选择和配置写入集中到一个界面里,目标是让用户少记命令、少改配置文件,打开工具就能完成主要流程。
支持的 Agent
当前支持以下终端 AI Agent,安装顺序和界面顺序一致:
| Agent | 安装包 | 命令 | 备注 |
|---|---|---|---|
| Claude Code | @anthropic-ai/claude-code | claude | 使用 Anthropic-compatible 配置 |
| Codex CLI | @openai/codex | codex | 使用 OpenAI-compatible 配置 |
| Gemini CLI | @google/gemini-cli | gemini | 使用 Gemini API Key |
| openclaw | openclaw | openclaw | 建议 Node.js 22.19+ 或 24+ |
| hermes | PyPI hermes-agent | hermes | 使用 venv 安装到 ~/.local/bin |
| reasonix | reasonix | reasonix | 使用 OpenAI-compatible 配置 |
| deepseek tui | codewhale | codewhale | CodeWhale 是 deepseek tui 的后续包 |
| opencode | opencode-ai | opencode | 使用 OpenAI-compatible provider |
功能
- 首次启动自动检测 Node.js / npm,并检测已安装 Agent 和版本。
- 缺少 Node.js / npm 时,可在界面中按
Enter确认安装。 - 安装页可直接按
Enter安装当前 Agent,也可用Space勾选多个 Agent 后批量安装/更新。 - npm 安装默认先用阿里/npmmirror 源,失败后自动切换官方源。
- Hermes 会使用
~/.local/share/all-agent/hermes-venv独立 venv 安装,避免污染系统 Python。 - 配置页只显示已安装的 Agent,避免给不存在的工具写配置。
- 支持创建 DeepSeek、Mimo、Gemini、自定义 Provider 的 API Key。
- 创建 API Key 时会测试模型列表,测试失败也可以强制填写模型保存。
- 应用 API Key 前有确认窗口,避免误写配置。
- API Key 和模型会写入各 Agent 的真实配置文件。
- 写入前自动备份已有配置,密钥相关文件会尽量设置为
chmod 600。
快速使用
从 GitHub Releases 下载 Linux x86_64 压缩包后:
tar -xzf all-agent-linux-x86_64.tar.gz
cd all-agent-linux-x86_64
chmod +x all-agent
./all-agent
如果希望全局使用:
sudo install -m 755 all-agent /usr/local/bin/all-agent
all-agent
界面和按键
程序包含 4 个页面:
| 页面 | 用途 |
|---|---|
| 帮助 | 查看工具功能和推荐流程 |
| 环境 | 检测 Node.js/npm,提示 Hermes 所需 Python/venv/pip |
| 安装 | 安装或更新 Agent,显示当前版本 |
| 配置 | 创建 API Key,选择模型,应用到已安装 Agent |
常用按键:
| 按键 | 作用 |
|---|---|
Tab | 切换页面 |
↑ / ↓ | 移动光标 |
← / → | 配置页切换左右区域 |
Space | 勾选/取消勾选 |
Enter | 确认、安装、创建、应用 |
Esc | 返回或取消弹窗 |
f | API Key 测试失败时强制填写模型 |
d | 配置页删除已保存 API Key |
Ctrl+C | 退出确认,再按一次可强制退出 |
配置写入位置
all-agent 会把 API Key 和模型写入对应工具实际读取的位置:
| Agent | 配置位置 |
|---|---|
| Claude Code | ~/.claude/settings.json,~/.claude/all-agent.env |
| Codex CLI | ~/.codex/config.toml,~/.codex/auth.json |
| Gemini CLI | ~/.gemini/settings.json,~/.gemini/all-agent.env |
| openclaw | ~/.openclaw/openclaw.json |
| hermes | ~/.hermes/config.yaml,~/.hermes/.env |
| reasonix | ~/.config/reasonix/config.toml,~/.config/reasonix/all-agent.env |
| deepseek tui / CodeWhale | ~/.codewhale/config.toml |
| opencode | ~/.config/opencode/opencode.json |
DeepSeek 和 Mimo 会按目标 Agent 自动转换地址:
| Provider | OpenAI-compatible | Anthropic-compatible |
|---|---|---|
| DeepSeek | https://api.deepseek.com | https://api.deepseek.com/anthropic |
| Mimo | https://token-plan-cn.xiaomimimo.com/v1 | https://token-plan-cn.xiaomimimo.com/anthropic |
Gemini API Key 主要用于 Gemini CLI,以及支持 Gemini provider 的工具。对于明确只支持 OpenAI-compatible 或 Anthropic-compatible 的 Agent,all-agent 会提示不兼容,不会静默写入无效配置。
从源码构建
需要 Rust 工具链:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
构建:
cargo build --release
运行:
./target/release/all-agent
打包
在 Linux 中执行:
./scripts/package-linux.sh
输出文件:
dist/all-agent-linux-x86_64.tar.gz
注意事项
- 当前主要面向 Linux x86_64。
- 中文 TUI 需要 UTF-8 终端环境。
- npm 源只在安装命令中临时指定,不会修改用户全局 npm 配置。
- 修改 Agent 配置前会自动备份,但仍建议保留自己的重要配置。
- 写入 shell 环境变量或
~/.local/binPATH 后,新开的终端会自动生效;当前已经打开的 shell 可能需要重新打开。
开发状态
已验证:
- Rust 单元测试通过。
- Linux release 构建通过。
- 隔离 home 下的 8 个 Agent 配置写入链路通过。
- 确认框不会因按键释放事件一闪而过。
后续计划:
- 增加更多 Linux 发行版的真实安装测试记录。
- 优化更多 Agent 的自动诊断信息。
- 提供更多架构的 Release 包。