The hard parts, handled · local-first · MIT复杂的事交给我 · 本地优先 · MIT

The hard parts, handled.
You just build.
复杂的事我来做好,
你只管开心地写代码。

Cost, capabilities, safety, collaboration — WorkGround2 handles the hard parts. Long sessions hold 90%+ cache hit and input-token cost drops to ~1/5; missing capabilities auto-route to helper models; edits stay approvable and rewindable. 成本、能力、安全、协作——这些复杂的事 WorkGround2 都替你扛。长会话缓存命中 90%+、token 成本降到 约 1/5;主模型缺的能力自动路由;改动可批准、可回滚。

Also via Homebrew and desktop apps · run WorkGround2 serve for the browser UI也可通过 Homebrew 与桌面端安装 · 运行 WorkGround2 serve 打开浏览器 UI
fig. 01 — a live session, cache still warm图 01 —— 一场实时会话,缓存依然温热
~/app — WorkGround2
◆ WorkGround2 v1.1.0 · deepseek-v4-flash · ~/app› add retry with backoff to the http client✓ edit internal/net/client.go +24 −3✓ edit internal/net/client_test.go +41 −0✓ run go test ./internal/net/ ok (0.21s)● 2 files · cache 94.2% → 95.1%›
cache 95.1% hitsession 18mmodel deepseek-v4-flashcost $0.043
Features特性

Built for long, cheap sessions.为长会话、低成本而生。

Most agents pay full price for the same growing prompt every turn. WorkGround2 keeps the prefix byte-identical so DeepSeek's cache does the heavy lifting — and everything else follows.多数 agent 每回合都为同一段不断增长的 prompt 付全价。WorkGround2 让前缀逐字节稳定,让 DeepSeek 的缓存替你扛下来——其余一切由此而来。

01 / cache-first

Cache-first loop缓存优先循环

Append-only history aligned to DeepSeek's prefix cache. 90%+ hit on long sessions; input tokens bill at ~1/5.append-only 历史对齐 DeepSeek prefix-cache。长会话 90%+ 命中,输入 token 约 1/5 计费。

02 / single binary

Single Go binary单个 Go 二进制

CGO-free, cross-compiled for darwin/linux/windows × amd64/arm64. No Node runtime to install or babysit.无 CGO,交叉编译覆盖 darwin/linux/windows × amd64/arm64。运行不需要 Node。

03 / mcp

MCP first-class

stdio, SSE, streamable HTTP. External servers merge their tools into one registry under a prefix.stdio、SSE、streamable HTTP。外部服务器的工具以前缀合并进同一 registry。

04 / plan + sandbox

Plan mode & sandbox计划模式 + 沙箱

Writers are jailed to the workspace; /plan gates the session read-only until you approve.写工具被关进工作区;/plan 进只读门,批准前不写盘。

$ /plan → read-only until approved
05 / subagents

Subagents & skills子智能体与技能

explore / research / review / security-review agents, plus Markdown skill scripts with isolated tools.explore / research / review / security-review 子智能体,加 Markdown 技能脚本与隔离工具。

06 / cli + web

Terminal or browser终端或浏览器

Use WorkGround2 in the terminal, or run WorkGround2 serve for a local browser UI with approvals, Goal, todos, and balance.在终端使用 WorkGround2,或运行 WorkGround2 serve 打开本地浏览器 UI,包含审批、Goal、Todo 与余额。

$ WorkGround2 serve --auth token
07 / collaboration

Everyone brings their own agent.每人一个自己的 Agent。

Join a Room — each person keeps their own agent, workspace and context, while proposals, deliverables, issues and verifications flow across the team. Offline-tolerant, idempotent, eventually consistent.进入同一个 Room——每个人保留自己的 Agent、工作区与上下文,意见、交付物、问题与验证结果在团队间自动流转。支持离线、幂等、最终一致。

Host IP · Port · Room → join
How it works工作原理

Every turn reuses the last.每一轮都复用上一轮。

Each request replays the exact same byte-for-byte prefix, so the model only computes what's new. Long sessions get cheaper per turn — not more expensive.每次请求都逐字节重放完全相同的前缀,模型只计算新增部分。会话越长,每轮越便宜——而不是越贵。

01Cold start — everything is computed冷启动——全部需要计算 02The previous turn replays from cache上一轮全部从缓存重放 03Only the new request is computed只计算新增的请求 0490%+ cache hit — cheaper every turn命中 90%+——越跑越便宜
turn 1
turn 2
turn 3
turn 4
new tokens — computed新 token——需要计算 cached prefix — replayed, billed at ~1/5缓存前缀——重放,约 1/5 计费
01

Install安装

One command. macOS, Linux, Windows, and WSL.一条命令,支持 macOS、Linux、Windows 与 WSL。

npm i -g WorkGround2@next
02

Point it at a repo指向你的仓库

WorkGround2 maps the codebase once, then keeps that map in the warm prefix.WorkGround2 只做一次代码库测绘,然后把这份地图常驻在温热的前缀缓存里。

cd your-project && WorkGround2
03

Open the web UI打开 Web UI

Keep it local, or add token/password auth before sharing a tunnel or remote port.本机使用保持默认;通过 tunnel 或远程端口分享前,先启用 token/password 认证。

WorkGround2 serve --auth token
04

Leave it running让它一直跑着

Queue tasks, review diffs, resume anytime. The session never goes cold.排任务、看 diff、随时恢复。会话永不冷却。

› refactor the auth flow
Community社区共建

Built in the open — be an early contributor.开源共建,邀请你成为首批贡献者。

WorkGround2 is MIT-licensed and developed in public. Star it, open an issue, send a PR, or share a real session — every contribution moves it forward.WorkGround2 采用 MIT 许可,开放开发。点个 star、提个 issue、发个 PR,或分享一次真实的使用过程——每个贡献都会推动它前进。

Start a session that lasts.开启一场不会中断的会话。

Open source under MIT. Bring your own DeepSeek API key — your code never leaves your machine and the model.MIT 开源。使用你自己的 DeepSeek API Key——代码不会离开你的机器与模型。

$npm i -g WorkGround2@next
npm i -g WorkGround2@nextv1.1.0 Go rewrite · one binary · no Node · actively developedGo 重写 · 单二进制 · 无需 Node · 主力开发中 recommended推荐
npm i -g WorkGround2v0.53 deprecated 0.x line · no longer maintained已废弃的 0.x 线 · 不再维护 deprecated已废弃
macOS / Linux / Windows / WSL · the latest tag is pinned at v0.53 — always install from @next · v1.1.0 release notes →macOS / Linux / Windows / WSL · latest 标签固定在 v0.53——请始终通过 @next 安装 · v1.1.0 更新说明 →
$brew install KiddPhenix/WorkGround2/WorkGround2
v1.1.0 (Go rewrite) · macOS & Linux · update with brew upgradev1.1.0(Go 重写)· macOS 与 Linux · 通过 brew upgrade 更新

macOS

Universal DMG · Apple Silicon & Intel通用 DMG · Apple Silicon 与 Intel Download Universal · v1.1.0下载通用版 · v1.1.0

Windows

Installer · Windows 10+ · x64 / ARM64安装器 · Windows 10+ · x64 / ARM64 Download · v1.1.0下载 · v1.1.0

Linux

Debian / Ubuntu package · amd64Debian / Ubuntu 安装包 · amd64 Download .deb · v1.1.0下载 .deb · v1.1.0
v1.1.0 · built-in auto-updates · same engine as the CLI · all releases →v1.1.0 · 内置自动更新 · 与 CLI 同一引擎 · 全部版本 →
macOS opens with a quarantine warning?macOS 提示无法打开或已损坏? If the app was installed from the official download and placed in /Applications, quit WorkGround2, then run:如果来自官网下载并已放入 /Applications,先退出 WorkGround2,再运行: sudo xattr -rd com.apple.quarantine /Applications/WorkGround2.app When to use this →查看适用场景 →