README.md

English | 中文

dsh-edge runs the published DeepSeek Harness Web experience on Cloudflare Workers, so your personal coding agent is available wherever you have a browser. No server to maintain, GitHub repository to connect, or build pipeline to configure.

It keeps the upstream UI, agent loop, model selection, and Web Search, while adding goal tracking, file operations, context compaction, runtime-configurable settings, and persistent multi-workspace management — all on Cloudflare Workers.

Independent community project: dsh-edge is maintained by pawaca. It is not affiliated with or endorsed by DeepSeek. DeepSeek Harness is the upstream project.

Start in one command

You need Node.js 22.14 or newer and your own DeepSeek API key:

npx dsh-edge install

The installer guides you through every choice and deploys the Worker. You can try it without an existing Cloudflare login, or install it permanently in your own Cloudflare account. No source checkout is required.

What you get

• Agent capabilities — goal tracking with GoalBar UI, file tools (read, write, edit, read_image), context compaction for long conversations, and automatic session titles.
• Workspaces — multiple persistent workspaces with create, rename, archive, and reorder; a /workspace filesystem backed by Durable Object SQLite; and a bash tool with configurable timeouts.
• Models — DeepSeek V4 Flash, V4 Pro, and Vision Exp through the upstream selector; runtime-configurable settings (model, API key, reasoning effort) without redeployment; Web Search and PNG/JPEG image input.
• Conversations — session fork to branch conversations, queue/steer message editing, persistent history from any browser.
• Deployment — your own Cloudflare Worker, credentials, and data; in-place upgrades without a repository or build pipeline.

Choose your deployment

Path	What you need	Best for
Try now	No existing Cloudflare login; claim within 60 minutes to keep it	Exploring the complete experience with the lowest friction
Keep it	An existing or new Cloudflare account with R2 enabled	A long-lived personal deployment

The default Free — Direct Shell runtime works on Cloudflare Workers Free. The optional Isolated — Dynamic Worker runtime executes commands in a separate Worker and requires Workers Paid. Both modes use the same product UI, conversations, workspace, images, and tools; Direct Shell is a sandboxed shell runtime, not a Linux container.

Upgrade

npx dsh-edge upgrade

The installer finds your Worker and upgrades it in place while preserving its durable data. See the release notes for version-specific details.

Important boundaries

• dsh-edge is designed for one owner; it does not provide registration, multiple users, roles, or tenant routing.
• Your DeepSeek key is stored as a Worker secret when set at deployment, or in Durable Object storage when configured through the runtime Settings UI. The deployment's durable data stays in your Cloudflare account.
• Some upstream capabilities (subprocess, PTY) require Cloudflare Containers and are not yet adapted. MCP over Streamable HTTP is feasible on the free plan but not yet installed. Vision Exp is experimental and account-dependent. See the compatibility matrix and the wiki for the full status.

Built on DeepSeek Harness

dsh-edge wraps exact published DeepSeek Harness packages instead of copying its monorepo. Upstream remains responsible for the Web UI, plugin composition, agent loop, and session protocols; this repository implements the Cloudflare runtime and storage adapters needed to run them at the edge.

For the upstream architecture and plugin APIs, see the DeepSeek Harness repository and reference documentation.

Documentation

• Architecture and subsystem wiki
• Runtime reference, compatibility, security, and limits
• Release notes
• DeepSeek Harness upstream documentation

Develop locally

Source checkout is only required for development. The repository toolchain requires Node.js ^22.19.0 or >=24.0.0:

git clone https://github.com/pawaca/dsh-edge.git
cd dsh-edge
pnpm install
pnpm --dir apps/dsh-edge/standalone install --frozen-lockfile
pnpm run check

See the local Edge setup to run the Worker locally.

Contributing and support

• Report dsh-edge bugs and installation problems in Issues.
• Report vulnerabilities through the private security process, not a public Issue.
• Follow CONTRIBUTING.md and AGENTS.md when changing the repository.

License

MIT. Third-party components and their licenses are listed in THIRD_PARTY_NOTICES.md.