How do I install Forge?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Forge need an API key?

No required environment variable is listed on this record.

When was Forge last checked?

Last checked 2026-10-28. Local-first ChatGPT MCP runtime for secure computer use, code, browser automation, and developer workflows.

Forge MCP server

Forge is a local-first ChatGPT MCP action runtime for permission-scoped computer use, software engineering, browser automation, and connected services. It is not an autonomous coding model or a hosted AI API.

Forge has no internal AI brain. One external controller owns semantic decisions; Forge provides the controlled execution, state, permissions, and recovery layer. ChatGPT is the recommended controller, but you can choose Codex, Claude, or another MCP client instead, and you may configure several controller entries while keeping one primary controller at a time.

With ChatGPT as the controller, Forge does not require a separate OpenAI API key or a second per-token model budget. Your existing ChatGPT plan/session limits still apply. Codex and Claude are not Forge dependencies unless you explicitly choose or configure them.

What Forge gives ChatGPT

Capability	What that means for you
Your local computer	Authorize a folder, then let ChatGPT list/read/write/copy/move files, create directories, open documents or Finder, run bounded commands, inspect processes, and manage verified macOS LaunchAgents.
Real software work	Inspect and edit repositories, run tests/builds, use Git and worktrees, keep long commands attached, verify results, commit, and clean temporary work.
Browser + desktop	Navigate, inspect, click, fill, screenshot, transfer files, and hand off when human interaction is required; Chrome/Vivaldi native attach and macOS desktop actions are supported where available.
Apple workflows	Build and inspect iOS projects, work with simulators/devices, and use App Store Connect for apps, builds, TestFlight, review state, and Xcode Cloud workflows.
Your services	Typed plugins for GitHub, Gmail, Google Calendar, Google Tasks, Resend, plus independently released Forge providers.
Automation + recovery	Long commands stay attached instead of being restarted; scheduled/recurring work can persist outside chat and hand control back to ChatGPT when reasoning is needed. Repository identity, checks, approvals, and recovery facts survive outside the conversation.

Ask for outcomes, not tools

“Clean up these generated files, run the project checks, commit the fix, and remove the worktree.”
“Read this authorized folder, reorganize the documents, and open the result in Finder.”
“Open the web app, test this flow in Chrome, capture evidence, then fix the UI regression.”
“Summarize today’s inbox, archive obvious promotions, and prepare the important replies.”
“Check the latest TestFlight build and tell me what blocks release.”

Forge deliberately keeps the tool mechanics below the conversation. You describe the goal to your chosen external controller; that controller decides, while Forge enforces scope, persistence, execution policy, and evidence. Forge never invents an internal agent just because Codex or Claude happens to be installed.

Start in minutes

Base install: Node.js 20.10+, npm (or Bun), and a writable home directory. Git is only required when you enable repository/software-work features; Codex and Claude are optional.

npm install -g @moretea-labs/forge
forge setup
# Recommended path; then follow one Next action at a time:
forge setup configure --controller chatgpt --tunnel auto
forge setup next

Setup persists progress and guides the selected path through the user-level Package Runtime, remote connectivity, controller registration, and connection verification. For ChatGPT, --tunnel auto now means OpenAI Secure MCP Tunnel first: Forge keeps the Canonical Runtime private, installs a loopback OAuth Gateway for ChatGPT, and lets the official tunnel-client carry MCP traffic outbound to OpenAI. Cloudflare Tunnel, Tailscale Funnel, an existing HTTPS /mcp URL, or deferred remote access remain explicit fallbacks when Secure Tunnel is unavailable. Local Codex/Claude controllers do not need a tunnel. The ChatGPT App/connector is the application identity; Secure Tunnel is only its network transport, so switching transport does not create a second Forge tool schema.

Then follow Install and start and Connect ChatGPT. A repository is optional during initial setup; add one later with forge adopt --repo /path/to/your-project. Upgrade an existing install with npm install -g @moretea-labs/forge@latest, verify with forge --version, then run forge setup next to reconcile newer Runtime/connector setup contracts.

For a reviewed source checkout: git clone https://github.com/moretea-labs/forge.git && cd forge && bun install --frozen-lockfile && npm install -g . --omit=optional --no-audit --no-fund.

Built in, and extensible

Forge ships typed local/browser/desktop/iOS/GitHub/Gmail/Calendar/Tasks/App Store Connect/Resend capabilities. On macOS, manage the native Computer capability with forge computer setup|status|doctor|update|uninstall; Forge Desktop Operator remains the independently released native provider behind that product surface. The generic provider catalog also includes Forge Design and Personal Knowledge Assistant and remains available through forge plugin catalog / forge plugin install <id>. Run forge computer doctor to verify readiness; updating the Forge CLI does not automatically update pinned native providers. See Computer and Plugins, Features, and Plugin Management.

Controlled by design

Local read/write grants are explicit and expiring; remote or destructive effects are distinguished from ordinary local work; high-impact actions require stronger confirmation. Full Access reduces repetitive prompts for normal work without removing the hard boundaries around secrets, destructive actions, and outside-workspace access. See Security and the Security Model.

Docs: GitHub Wiki · Wiki source · Support · Contributing · Changelog. Current stable release: v1.8.2; stable installs use npm latest.

Forge 是一个本地优先的 ChatGPT MCP 执行运行时，将 AI 对话连接到有权限边界的电脑操作、代码开发、浏览器自动化和外部服务，而不是额外的在线 AI 模型。

Forge 自己没有 AI 大脑。 语义判断始终由一个外部主控负责，Forge 负责受控执行、持久状态、权限和恢复。推荐 ChatGPT，也可以明确选择 Codex、Claude 或其他 MCP 客户端；可以预配置多个入口，但同一时刻只有一个主控负责决策。

选择 ChatGPT 时不要求再配置一份 OpenAI API Key，也不需要额外准备一套按 token 计费的模型预算；仍受你的 ChatGPT 套餐和会话限制。Codex、Claude 没被选中时就不是 Forge 的依赖。

Forge 能让 ChatGPT 做什么

能力	用户真正得到什么
操作本机	授权一个目录后，可列出/读取/写入/复制/移动文件，创建目录，打开文档或 Finder，执行受控命令，查看进程并管理经过身份校验的 macOS LaunchAgent。
完成真实开发任务	读取和修改仓库、运行测试/构建、操作 Git/worktree、持续跟踪长命令、验证结果、提交并清理临时工作区。
浏览器与桌面	页面导航、读取、点击、填写、截图、文件传输；需要人工时再 handoff；可使用 Chrome/Vivaldi 原生 attach 与 macOS 桌面能力。
Apple 工作流	iOS 构建、模拟器/设备，以及 App Store Connect 的版本、构建、TestFlight、审核状态和 Xcode Cloud。
连接你的服务	GitHub、Gmail、Google Calendar、Google Tasks、Resend，以及独立发布的 Forge Provider。
自动化与可恢复执行	长命令不会因为聊天继续而重跑；定时/周期工作可以持久化，在需要判断时再交回 ChatGPT。仓库身份、检查、授权与恢复状态也不只存在于聊天上下文里。

“把这个 bug 修好，跑完测试，提交，然后把临时 worktree 清掉。”
“读取我授权的这个目录，整理文件，并在 Finder 里打开结果。”
“在 Chrome 里把这个流程走一遍，截图核对，然后修 UI。”
“汇总今天邮件，把明显广告归档，重要邮件整理给我。”
“看最新 TestFlight 构建，告诉我离发布还差什么。”

快速开始

基础安装只需要 Node.js 20.10+、npm（或 Bun）和可写用户目录。Git 只在启用仓库/软件开发能力时需要；Codex、Claude 都是可选项。

npm install -g @moretea-labs/forge
forge setup
forge setup configure --controller chatgpt --tunnel auto
forge setup next     # 按每次显示的 Next 动作继续

远程主控的 setup 会继续引导 Package Runtime、远程连接、主控配置和连接验证；对 ChatGPT，--tunnel auto 现在明确表示 优先 OpenAI Secure MCP Tunnel。Forge 保持 Canonical Runtime 私有，并安装一个仅监听 loopback 的 OAuth Gateway，再由官方 tunnel-client 出站连接 OpenAI。只有 Secure Tunnel 不可用时才显式选择 Cloudflare Tunnel、Tailscale Funnel、已有 HTTPS /mcp 或暂缓远程连接。本地 Codex/Claude 主控不需要 tunnel。ChatGPT App/connector 是应用身份，Secure Tunnel 只是网络传输层，因此切换网络不会产生另一套 Forge 工具 schema。

继续阅读安装与启动和连接 ChatGPT。仓库不是首次 setup 的前置条件，需要开发能力时再运行 forge adopt --repo /path/to/your-project。已安装用户升级：npm install -g @moretea-labs/forge@latest，确认 forge --version 后运行 forge setup next 让新版 setup 自动补齐 Runtime/connector 配置。源码安装：git clone https://github.com/moretea-labs/forge.git && cd forge && bun install --frozen-lockfile && npm install -g . --omit=optional --no-audit --no-fund。

Forge 内置本机、Browser、Desktop、iOS、GitHub、Gmail、Calendar、Tasks、App Store Connect、Resend 等类型化能力。macOS 原生 Computer 能力统一通过 forge computer setup|status|doctor|update|uninstall 管理；Forge Desktop Operator 仍作为其独立发布的原生 Provider 保持稳定身份。通用 Provider 目录还包含 Forge Design / Personal Knowledge Assistant，继续使用 forge plugin catalog / forge plugin install <id> 管理。升级 Forge CLI 不会自动升级独立 Provider；Computer 用户须运行 forge computer update，并用 forge computer doctor 检查状态。详见 Computer 与插件安装指南、功能清单与插件管理。

安全上，普通本地修改、远程影响、破坏性操作、密钥和工作区外访问是不同边界；Full Access 不会取消高风险确认。详见安全说明和安全模型。

文档： GitHub Wiki · Wiki source · 支持 · 贡献 · 更新日志。当前稳定版为 v1.8.2，稳定安装使用 npm latest。

Capability

What that means for you

Your local computer

Authorize a folder, then let ChatGPT list/read/write/copy/move files, create directories, open documents or Finder, run bounded commands, inspect processes, and manage verified macOS LaunchAgents.

Real software work

Inspect and edit repositories, run tests/builds, use Git and worktrees, keep long commands attached, verify results, commit, and clean temporary work.

Browser + desktop

Navigate, inspect, click, fill, screenshot, transfer files, and hand off when human interaction is required; Chrome/Vivaldi native attach and macOS desktop actions are supported where available.

Apple workflows

Build and inspect iOS projects, work with simulators/devices, and use App Store Connect for apps, builds, TestFlight, review state, and Xcode Cloud workflows.

Your services

Typed plugins for GitHub, Gmail, Google Calendar, Google Tasks, Resend, plus independently released Forge providers.

Automation + recovery

Long commands stay attached instead of being restarted; scheduled/recurring work can persist outside chat and hand control back to ChatGPT when reasoning is needed. Repository identity, checks, approvals, and recovery facts survive outside the conversation.

“Clean up these generated files, run the project checks, commit the fix, and remove the worktree.” “Read this authorized folder, reorganize the documents, and open the result in Finder.” “Open the web app, test this flow in Chrome, capture evidence, then fix the UI regression.” “Summarize today’s inbox, archive obvious promotions, and prepare the important replies.” “Check the latest TestFlight build and tell me what blocks release.”

能力

用户真正得到什么

操作本机

授权一个目录后，可列出/读取/写入/复制/移动文件，创建目录，打开文档或 Finder，执行受控命令，查看进程并管理经过身份校验的 macOS LaunchAgent。

完成真实开发任务

读取和修改仓库、运行测试/构建、操作 Git/worktree、持续跟踪长命令、验证结果、提交并清理临时工作区。

浏览器与桌面

页面导航、读取、点击、填写、截图、文件传输；需要人工时再 handoff；可使用 Chrome/Vivaldi 原生 attach 与 macOS 桌面能力。

Apple 工作流

iOS 构建、模拟器/设备，以及 App Store Connect 的版本、构建、TestFlight、审核状态和 Xcode Cloud。

连接你的服务

GitHub、Gmail、Google Calendar、Google Tasks、Resend，以及独立发布的 Forge Provider。

自动化与可恢复执行

长命令不会因为聊天继续而重跑；定时/周期工作可以持久化，在需要判断时再交回 ChatGPT。仓库身份、检查、授权与恢复状态也不只存在于聊天上下文里。

“把这个 bug 修好，跑完测试，提交，然后把临时 worktree 清掉。” “读取我授权的这个目录，整理文件，并在 Finder 里打开结果。” “在 Chrome 里把这个流程走一遍，截图核对，然后修 UI。” “汇总今天邮件，把明显广告归档，重要邮件整理给我。” “看最新 TestFlight 构建，告诉我离发布还差什么。”

Forge

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Forge?

Does Forge need an API key?

What transport does Forge use?

When was Forge last checked?

Documentation

What Forge gives ChatGPT

Ask for outcomes, not tools

Start in minutes

Built in, and extensible

Controlled by design

Forge 能让 ChatGPT 做什么

快速开始

Forge

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Forge?

Does Forge need an API key?

What transport does Forge use?

When was Forge last checked?

Documentation

What Forge gives ChatGPT

Ask for outcomes, not tools

Start in minutes

Built in, and extensible

Controlled by design

Forge 能让 ChatGPT 做什么

快速开始