Repository navigation
Releases
v0.4.2
- A brief or prompt that holds
$&,$`or$'(common in code, for example areplacecall)
now reaches the worker as written. Before, filling the{prompt}placeholder expanded them, so the
worker got a changed prompt and nothing reported it. (#2, thanks @minhz) - A prompt that holds a placeholder name (
{workspace},{timeoutSec},{conversationId},{model})
also reaches the worker as written. Before, backends that take the prompt as an argument (the default
agybackend) filled those names inside the prompt too.
v0.4.1
Fixes
- Dashboard on a fresh install:
offload-mcp-server dashboardno longer fails withENOENTbefore any job has run. (#1, thanks @thanhnguyen293 🙏) - Several sessions at once: a server that starts while another session is running no longer marks that session's jobs as
interrupted. (#1, thanks @thanhnguyen293) - Other sessions' jobs are live:
offload_get_statusshows their real state and waits for them, jobs created after this server started are found,offload_followupcan continue them, andoffload_cancel_taskasks the owning server to stop the worker.
Upgrade: npx -y offload-mcp-server@latest setup, then reload your editor. Details in CHANGELOG.md.
v0.4.0: live dashboad
Watch offload jobs live
New command: npx -y offload-mcp-server dashboard opens a local web page that shows every job from every session.
- Live timeline of each file the worker opens, plus its own remarks and the final result
- Coverage bar that fills as the worker reads the files in scope
- The worker's question, brief check, injection and secret warnings at a glance
- Brief, report, scope and log tabs; every
path:linein the report opens in VS Code - Cancel a running job from the page, even one started by another Claude session
- Jobs whose server has exited are marked instead of showing "running" forever
- 11 languages (same as the README); follows your browser, with a picker in the header
- Light and dark themes, works on narrow screens
Local only: listens on 127.0.0.1, needs a one-time token from the printed link (kept in a SameSite=Strict cookie), checks the Host header, and cancel also needs the page's Origin plus a custom header. No new dependencies.
Config: "dashboard": { "port": 7431, "autoOpen": false }. With autoOpen: true the dashboard starts with the first job, and the submit result gives Claude the link for you.
Upgrade: npx -y offload-mcp-server@latest setup, then reload your editor. Full notes in CHANGELOG.md.
v0.3.0
Live progress, follow-ups and coverage.
npx -y offload-mcp-server@latest setup
- Live progress: the status shows the worker's latest step while it runs
- Coverage: which in-scope files the worker never opened, measured from its own file reads
- offload_followup: ask the worker more in the same conversation; it keeps what it read (seconds, not minutes)
- ASK: a worker blocked on a decision asks you instead of guessing
- tier low/medium/high per job (detected by setup), reuse of identical finished jobs
- Reports: secrets masked, instruction-like text flagged, stricter path:line citations
- Safer worker runs: no slash-command expansion, no nested delegation, clear quota errors
Upgrading from 0.2: run setup again; it upgrades your config and keeps a .bak.
Full list: CHANGELOG.md
v0.2.1
Now on npm and listed for the official MCP Registry.
npx -y offload-mcp-server setup
- setup command: installs the read-only worker agent, the Claude Code skill and the config, and registers the server with Claude Code
- Jobs for the Antigravity CLI stop with a clear message when the worker agent is not installed, instead of returning an empty answer
Full list of changes: CHANGELOG.md
v0.1.0
First public release of offload-mcp-server: an MCP server that lets your main coding agent (Claude Code) hand heavy read-only work to a second agent CLI running in the background (by default the Antigravity CLI), and read back only a compact report.
Measured on a real project
Inventory of every HTTP endpoint in 37 PHP files (140 KB):
| Worker (Antigravity CLI, Gemini Flash) | 503 s, 192k tokens on the Google quota |
| Main agent, Summary only | ≈ 0.5k tokens |
| Reading the files directly | ≈ 40k tokens |
| Spot check | 6 of 6 cited lines matched |
Highlights
- Four tools:
offload_submit_task,offload_get_status,offload_get_result,offload_cancel_task. Submit a job, keep working, collect it later. - Structured brief:
task,steps,output_hintanddone_whenare required. The worker executes the steps literally and returns a Step log; the status shows which steps it did not finish. - Scoped and read-only: the worker gets the list of files in scope and a read-only agent; the server reports any file whose
git statuschanged during a job. - Backend-agnostic: any CLI with a non-interactive mode works, including
claude -p. - Tested on Ubuntu and Windows in CI; full setup tested on Windows 10 with Antigravity CLI 1.5.3.
- README in 11 languages.
Install
See the step-by-step setup. Not on npm yet.
Full list of changes: CHANGELOG.md
