Skip to content

Releases

v0.4.2

Choose a tag to compare

@tailucanh tailucanh released this 10 Nov 13:13
  • A brief or prompt that holds $&, $` or $' (common in code, for example a replace call)
    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
    agy backend) filled those names inside the prompt too.

v0.4.1

Choose a tag to compare

@tailucanh tailucanh released this 09 Nov 12:22

Fixes

  • Dashboard on a fresh install: offload-mcp-server dashboard no longer fails with ENOENT before 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_status shows their real state and waits for them, jobs created after this server started are found, offload_followup can continue them, and offload_cancel_task asks 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

Choose a tag to compare

@tailucanh tailucanh released this 08 Nov 15:53

Watch offload jobs live

New command: npx -y offload-mcp-server dashboard opens a local web page that shows every job from every session.

offload dashboard

  • 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:line in 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

Choose a tag to compare

@tailucanh tailucanh released this 08 Nov 12:25

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

Choose a tag to compare

@tailucanh tailucanh released this 08 Nov 07:08

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

Choose a tag to compare

@tailucanh tailucanh released this 08 Nov 06:06

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.

demo

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_hint and done_when are 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 status changed 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