forge-delegate

Name: forge-delegate
Author: MuhamadBarzani

作者：MuhamadBarzani版本 1.2.4i★ –i在你的电脑上运行

注册名称io.github.MuhamadBarzani/forge-delegate

安装

概览

作者提供的说明（英文原文）

Delegate coding tasks from Claude Code, Codex or opencode to any model opencode can run.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 其他

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
注册中心没有列出需要填写的密钥。

你需要

npm已安装 Node.js（用于 npx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "forge-delegate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-delegate",
        "serve"
      ]
    }
  }
}

在终端中运行这条命令

claude mcp add forge-delegate -- npx -y forge-delegate serve

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "forge-delegate": {
      "command": "npx",
      "args": [
        "-y",
        "forge-delegate",
        "serve"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "forge-delegate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "forge-delegate",
        "serve"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 MuhamadBarzani 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“其他”中的其他服务器比较i

星标数多于此分类中其他 32712 个服务器的 0%
发布到注册中心的时间比此分类中其他 32712 个服务器的 77% 更新
基础检查结果等于或优于此分类中其他 32712 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

forge-delegate 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（1.2.4）于11天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Aiterm MCP

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新

安装

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211前天更新

安装

Aiterm MCP

作者：kitepon

Persistent terminals and one launcher for Claude, Codex, Grok, Cursor, and Antigravity harnesses.

在你的电脑上运行今天更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

forge-delegate

MCP server that delegates coding work from your primary agent (Claude Code, Codex, or opencode) to other AI models, so your main agent's context stays small. The high-volume typing happens in another model's context, usually a cheaper or free one, and only a summary comes back. Full agentic delegation via opencode for real work; direct API calls for second opinions.

Your main agent (the expensive one) keeps architecture, critical logic, and hard decisions. The cheap model grinds through the high-volume, low-risk work (boilerplate, repetitive edits, tests, lint/type fixes) and reports back.

┌──────────────────┐   MCP (stdio)   ┌──────────────────┐   opencode run   ┌──────────────────┐

│ Claude / Codex / │ ──────────────► │ forge-delegate │ ───────────────► │ opencode + cheap │ │ opencode (primary)│ │ (this server) │ --model cheap │ model │ └──────────────────┘ ◄────────────── └──────────────────┘ ◄─────────────── └──────────────────┘ result: text + session + token usage

Quick start

Web configurator — pick model/targets/scope and get a ready-to-paste command (https://muhamadbarzani.github.io/forge-delegate/). The model picker is backed by the live models.dev catalog — searchable, with free/cheap filters and real prices, so you're picking from actual available models rather than guessing.

npx (recommended — works everywhere, no bash needed):

npx -y forge-delegate setup --model "opencode/deepseek-v4.1-flash-free" --targets "claude,codex,opencode"

That's it — npx bootstraps the package, and setup registers the MCP server with the agents you chose, sets your default model, and installs a small launcher that keeps the server up to date. Works on Windows (cmd/PowerShell), macOS, and Linux — no bash needed.

Run setup without flags and it walks you through the choices interactively (defaults in [brackets], Enter accepts). For the default model it lists every model your opencode can run and you pick one by number or name; pass any of the flags to skip that prompt. In an automated/non-terminal run it just uses sensible defaults.

GitHub Pages: enable it with *Settings → Pages → Deploy from a branch → main / /docs*.

The configurator lives at docs/index.html. install.sh's FORGE_DELEGATE_REPO default

(and the raw URL inside it) matters only if you self-host the fallback installer.

Working on a checkout yourself? node cli.mjs setup does the same thing.

setup will:

Register the MCP server with each agent you chose (--targets claude,codex,opencode).
Set your default model (--model) so calls can omit model.
Install the auto-update launcher (published installs; skipped for a git checkout).
For Codex, raise the MCP timeouts (startup_timeout_sec, tool_timeout_sec) above Codex's 10s/60s defaults so inline delegations aren't cut off.

Routing and cost-policy guidance is injected by the MCP server itself into the agent's context via MCP instructions — no memory-file (CLAUDE.md/AGENTS.md) editing needed.

Then restart your agent and confirm the server is connected: /mcp in Claude Code, codex mcp, or opencode.

What you need

Node.js ≥ 18 and opencode v2 or newer installed (the installer can fetch opencode for you). v2 removed the CLI flags older versions relied on for working directories and variants, and an unknown flag makes opencode run print help and exit successfully — so a pre-v2 binary fails silently. The server checks at startup and warns instead.
**Free opencode/* models** (e.g. opencode/deepseek-v4.1-flash-free) need no auth — zero setup.
Any other provider (deepseek, openai, google, ollama, …) must be logged into your opencode first — that's a step *you* do in your own opencode, not something forge-delegate handles: opencode auth login . forge-delegate reuses your opencode's credentials and never stores API keys. (Ollama needs no key, just the Ollama app running.)

Windows

Use the npx route — no bash needed (works in cmd/PowerShell). All three targets, including native Windows Codex CLI, are supported.

Scope

`--scope`	Claude Code	Codex	opencode
`user` (default)	`~/.claude.json` — all projects	`~/.codex/config.toml` — all projects	`~/.config/opencode/opencode.json` — all projects
`project`	`.mcp.json` in the project (needs one-time approval)	`.codex/config.toml` in the project (loads for trusted projects only)	`opencode.json` in the project

Try it free — zero signup

opencode ships free no-auth models under opencode/:

npx -y forge-delegate setup --model "opencode/deepseek-v4.1-flash-free" --targets "claude,codex"

Other free options: opencode/mimo-v2.6-flash-free, opencode/nemotron-3.5-lightning-free. Free tiers are rate-limited; switch anytime with forge-delegate config set --model .

Tools

Tool	What it does	Context cost
`ask_model`	Second opinion from another model (direct API, no file access)	Small
`delegate`	Model works autonomously via opencode's own tool loop — inline by default; `background:true` returns a job id to poll via `check_delegation`	Tiny→Medium
`check_delegation`	Poll a background job (or list all with no id)	Tiny
`list_models`	List local/keyless, direct-API, and agentic models	Small
`get_delegate_config`	Read current configuration (default model, directory, autoApprove, profiles)	Tiny
`set_delegate_config`	Change configuration at runtime — no reinstall	Tiny

delegate is the context-saver: the external model gets its own tool loop executed by opencode locally. File contents never touch your main agent's context. Fast tasks return inline; long ones are auto-backgrounded by Claude Code (past ~2 min). Other hosts wait for an inline call, so the agent is told to pass background:true there for anything long.

Each delegation's result ends with the tokens it used and, when the provider reports prices, its cost. forge-delegate stats totals both per model.

When to delegate

✅ Delegate — high volume, low risk	⛔ Keep on the primary agent
Tests for well-specified behavior	Architecture, system design, choosing abstractions
Boilerplate & scaffolding (CRUD, DTOs, fixtures, mocks)	Security-sensitive code (auth, crypto, secrets, permissions)
Mechanical edits across many files (renames, prop propagation, imports)	Concurrency, performance-critical paths, subtle correctness
Lint / formatting / type-error fixes	Ambiguous / underspecified requirements needing judgment
Docstrings, comments, README / changelog sections	Public API / interface design, breaking changes
Straightforward data transforms / migrations with a clear spec	Debugging unknown root causes
Obvious glue code / format conversions	Anything costly or hard to detect if wrong

Full guide: docs/DELEGATION.md

The `delegate-work` skill

Setup also installs the skill for Claude Code (~/.claude/skills/delegate-work/, or /.claude/skills/ under --scope project) and for Codex (~/.agents/skills/delegate-work/, or /.agents/skills/). Skip it with --no-skill.

It exists because MCP server instructions are injected once at session start and get buried as the context fills — by turn 30 they lose to whatever is in front of the model. A skill description is re-matched against every user turn, so the delegation triggers ("write tests for", "rename X everywhere", "fix the lint errors") stay live for the whole session instead of decaying.

Configuration

Stored in ~/.forge-delegate/config.json, read fresh on every call — change it anytime without reinstalling. Four ways:

From your agent via the MCP tools get_delegate_config / set_delegate_config.
Terminal CLI: forge-delegate config get, forge-delegate config set --model --timeout --dir --autoApprove false, forge-delegate config path.
`setup` flags: --model, --targets, --scope, --project-dir.
Edit the file directly.

Field	Description	Default
`defaultModel`	provider/model used when a call omits `model`	unset
`defaultAgent`	opencode agent used for delegations	unset
`defaultVariant`	default reasoning-effort variant	unset
`autoApprove`	auto-approve permissions so headless delegations don't block	`true`
`timeoutMs`	per-delegation timeout	`900000` (env `FORGE_OPENCODE_TIMEOUT`)
`defaultDirectory`	default working directory for delegations	unset (server cwd)
`profiles`	named presets `{ name: { model, agent, variant, autoApprove, directory } }`	`{}`

Every delegation tool also accepts per-call model, directory, agent, autoApprove, and profile overrides. Per-call values beat profile values beat config defaults.

Models

opencode provider — free no-auth models (opencode/deepseek-v4.1-flash-free, ...) plus anything you have logged in via opencode auth login .
Direct API from opencode logins — provider/model for OpenAI-compatible providers.
Custom providers — OpenAI-compatible providers defined in opencode.json (@ai-sdk/openai-compatible + baseURL), callable as provider/model.
Ollama (local) — ollama:llama3, local:qwen2.5-coder, no key needed.

Safety notes

autoApprove: true runs delegations non-interactively with tool permissions granted — point them at repositories you trust and review the diffs. Set autoApprove: false to require manual approval.
This server never stores API keys — provider auth lives in opencode's own auth store.
Usage is logged to ~/.forge-delegate/usage.jsonl; see forge-delegate stats.

CLI

forge-delegate --version  Print the installed version

forge-delegate setup Register with Claude Code / Codex / opencode forge-delegate serve Start the MCP server (used internally) forge-delegate config get | set | path forge-delegate status Show version, update mode, opencode logins, usage forge-delegate stats Show detailed usage statistics

setup on a published install writes ~/.forge-delegate/launcher.mjs and registers that path instead of npx. The launcher keeps a private install under ~/.forge-delegate/pkg, asks npm for the newest release at most every 6 hours, and installs newer same-major versions automatically. Installs use npm install --ignore-scripts, go through a staging directory, and fall back to the last good version if anything fails. A new version lands on the next agent start; the download itself happens in the background so startup is never delayed.

Disable automatic updates with FORGE_AUTO_UPDATE=0. A major release (2.0.0) is never installed automatically — re-run npx -y forge-delegate setup to take it deliberately.

The launcher is also the CLI entry point: node ~/.forge-delegate/launcher.mjs status reports the running version and update mode, and --version prints the version.

npx installs configured by hand are not covered by the launcher: npx keeps its cached copy forever, so clear it with rm -rf ~/.npm/_npx and restart. Running npx -y forge-delegate@latest setup migrates an npx install to the launcher; @latest gets its own npx cache slot, and if it still starts an old version, clear the cache first.

Publishing (npm)

The primary install is npx -y forge-delegate setup, so the package must be on npm. Checklist:

npm run prepublishOnly — syntax-checks all entry files (runs automatically on publish).
npm pack --dry-run — confirm the tarball contains only launcher.mjs, cli.mjs, server.mjs, lib.mjs, install.sh, docs/, skills/, README.md (via the files field), not node_modules.
Bump

只显示了开头部分；其余内容请在仓库中阅读

forge-delegate

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“其他”中的其他服务器比较i

常见问题

替代选择

Spec Driven Development

Remote Desktop Commander

Aiterm MCP

作者的 README

forge-delegate

Quick start

What you need

Windows

Scope

Try it free — zero signup

Tools

When to delegate

The delegate-work skill

Configuration

Models

Safety notes

CLI

Publishing (npm)

The `delegate-work` skill