Config 命令

提供商、成本、看板、品牌、atlas、技术栈与可选 MCP 集成:config、cost、dash、brand、atlas、stack、report、tools、integrations。

Config 组涵盖提供商、可观测性、代码图和技术栈检测。

​

forge config

提供商设置 —— 显示 / 切换 / 添加提供商,设置默认模型。

forge config               # show current config
forge config switch <provider>
forge config add <provider>

​

forge cost

通过实测的阶段因子给出真实的每日花费。

forge cost                 # real per-day spend
forge cost --stages        # measured per-stage cost factors

只报告实测过的阶段 —— 没有事件的阶段会显示”no data”,而不是给出默认值。

​

forge dash

基于账本、指标和爆炸半径的本地看板。

forge dash                 # localhost-only, read-only (default port 4242)

​

forge brand

打印当前生效的品牌 token 映射。

forge brand

品牌以单一 token(brand.json)存储;换品牌只需一次编辑。

​

forge atlas

构建 / 查询代码图。

forge atlas build [path]   # walk the tree → .forge/atlas.json
forge atlas query "what calls Z"
forge atlas has <symbol>   # hallucinated-symbol check

atlas 是纯 JSON —— 任何工具都能读,不需要 MCP。

​

forge stack

从仓库的清单文件中检测其真实技术栈。

forge stack

读取 package.json、pyproject.toml、go.mod、Cargo.toml、Gemfile、 composer.json、pom.xml / build.gradle 以及 *.csproj,报告语言、框架、包管理器,以及仓库真正的测试命令 —— 这些会喂给基座的验证清单。

​

forge report _v0.19+

生成仓库 Forge 状态的静态 HTML 报告 —— 把账本、指标和爆炸半径渲染到一个自包含的文件里,可以分享或存档。

forge report

​

forge tools _v0.19+

选择该仓库的主要 AI 编码工具,并接入匹配的 .gitignore 条目,让生成的配置和 .forge/ 产物在你的环境下被正确忽略。

forge tools

​

forge integrations

选择性接入的第三方 MCP 服务器(例如 context7),在 Forge 生成配置的每一个工具中被非破坏性地统一管理 —— Claude Code、Codex、Cursor、Gemini、Continue 等。

第三方 MCP 服务器默认不安装。在你运行 forge integrations add <name> --yes 之前,不会有任何东西落到磁盘上。

forge integrations                        # list opt-in servers with package + purpose
forge integrations add <name>             # dry-run: prints package, network, files it would touch
forge integrations add <name> --yes       # apply — write MCP config for every tool
forge integrations add <name> --yes --adopt   # also claim a same-name entry you already configured
forge integrations remove <name>          # reverse the add — deletes only forge-owned entries

​

add 会写入什么

add --yes 会从同一份规范化的 spec 里把该服务器写入每个工具原生的 MCP 配置:

• .mcp.json(Claude Code)
• .cursor/mcp.json(Cursor)
• .gemini/settings.json(Gemini)
• .codex/config.toml —— 作为一个 # forge:managed:<name> 块,通过逐字节比较刷新
• .continue/mcpServers/<name>.yaml —— 每个被管理的服务器一个 forge 标记过的 YAML
• 以及 Forge 生成配置的其他工具

已安装的集合会记录在 .forge/forge.config.json 的 mcp.integrations 下,因此后续每次 forge sync 都会重新生成同样的服务器。stop-hook 的自动同步会对整个配置文件做逐字节比较,所以对该文件的手工编辑会被检测出来并修复。

​

--adopt 的语义

如果某个工具的配置文件里已经存在同名服务器、而不是 Forge 放进去的,add 不会覆盖它。它会报告该文件,并附上 --adopt 提示。加上 --adopt 重新运行以认领所有权 —— Forge 会把该条目记录在 .forge/forge.config.json 的 mcp.adopted 下,并从此接管它。

当你之前手工配置过某个服务器,现在想让 Forge 在每个工具间保持它同步时,就使用 --adopt。

​

remove

forge integrations remove <name> 是对 add 的反向操作。它只删除 forge 拥有的条目、块和文件 —— 用户自己配置过、且从未 --adopt 过的同名服务器不会被动。运行两次 remove 是无操作的。

forge integrations remove context7

​

.forge/forge.config.json

单仓库的 Forge 状态 —— 同时也保存 primaryTool、tools 和 profile 的统一配置 —— 在两个键下记录选择性接入的集成:

{
  "mcp": {
    "integrations": ["context7"],
    "adopted": []
  }
}

未知的键会在写入时被原样保留。格式错误的文件不会被静默丢弃:读取时每个进程会在 stderr 上警告一次,写入方会拒绝覆盖一份无法解析的配置,而不是把它替换成默认值。