面向终端的 AI 编程助手,支持 300+ 模型、三种交互模式与内置 Agent 体系
Forge 是一款基于 Rust 构建的 AI 增强终端编程环境,由 TailcallHQ(原 AntinomyHQ)开发维护,采用 Apache-2.0 许可证。项目已从 antinomyhq/forge 迁移至 tailcallhq/forgecode。
多模型支持#
支持 OpenAI、Anthropic Claude、Google Gemini、xAI Grok、DeepSeek、Vertex AI 等 300+ 模型,通过 forge provider login 配置凭据,会话内可动态切换(:model)。
三种交互模式#
| 模式 | 入口 | 典型用途 |
|---|---|---|
| Interactive Mode (TUI) | forge | 持久会话,多步开发任务 |
| One-Shot CLI | forge -p "..." | 脚本/管道集成,单次问答 |
ZSH Plugin(: 前缀) | : <prompt> | 零切换开销,直接在 shell prompt 中调用 |
内置 Agent 体系#
| Agent | 触发方式 | 能力定位 |
|---|---|---|
forge | 默认 | 实现型:读写文件、构建功能、修复 Bug、运行测试 |
sage | :ask | 研究型:只读代码、映射架构、追踪数据流 |
muse | :plan | 规划型:分析结构,输出实现计划至 plans/ 目录 |
工作流扩展#
- Skills 系统:可复用工作流模板,内置
create-skill、execute-plan、github-pr-description,支持项目级/全局级自定义(SKILL.md+ YAML front-matter) - 自定义 Agent:
.forge/agents/目录下通过 Markdown + YAML front-matter 定义 - 自定义命令:
.forge/commands/目录下通过 YAML 定义快捷命令 - AGENTS.md:项目根目录持久化指令文件,自动注入每次对话
开发辅助能力#
- 语义搜索:
:sync索引代码库,支持语义级别检索 - Git 集成:
:commitAI 生成 commit message 并提交,--preview预览模式 - Shell 命令建议:
:suggest自然语言转 shell 命令 - 会话管理:
forge conversation resume <id>恢复历史会话
安全与隔离#
- Restricted Shell:限制文件系统访问范围,防止意外更改
- Sandbox 模式:
--sandbox参数创建隔离的 git worktree + 独立分支
架构要点#
- Rust Cargo Workspace monorepo,
crates/下含多个子模块(如forge_repo) - Diesel ORM 用于本地会话持久化与索引存储
forge.schema.json提供 JSON Schema 配置验证Cross.toml支持交叉编译(musl/gnu targets)- 提供
flake.nix支持 Nix 原生运行,同时支持 Dev Container 部署 - MCP(Model Context Protocol)工具协议支持
- Workspace Server 默认连接
https://api.forgecode.dev,可通过FORGE_WORKSPACE_SERVER_URL覆盖
安装与快速开始#
curl -fsSL https://forgecode.dev/cli | sh
forge provider login
forge
Nix 方式:nix run github:tailcallhq/forgecode
ZSH 插件安装:forge setup,安装后即可在 shell prompt 中使用 : 前缀调用。
配置体系#
- 全局配置:
~/forge/.forge.toml - 会话级动态配置:
:model、:reasoning-effort、:agent - 持久化配置:
:config-model、:config-provider、:config-reasoning-effort - 项目级配置:
.forge/目录下的 Agent、Commands、Skills 定义
适用场景#
代码理解与审查、新功能实现、调试辅助、遗留代码重构、数据库 Schema 设计、Git 操作自动化、自然语言转 shell 命令、代码库语义搜索、项目规划与实现计划生成。
待确认信息#
antinomyhq/forge→tailcallhq/forgecode的确切迁移日期未公开确认- TermBench 2.0 排名细节:官网自称领先,但未找到具体评测报告链接
- Workspace Server(
api.forgecode.dev)的付费模式未明确说明 - Windows 支持状态待确认