# Cosyncing: Control DeepSeek Harness and other agents on your phone > Source: > Published: 2026-08-17 23:13:21+00:00 **From CLI to GUI, live and in sync** [Website](https://cosyncing.com/) · [Install](#install) · [Client](#client) · [Docs](/cosyncing/cosyncing/blob/main/docs/README.md) · [Contributing](/cosyncing/cosyncing/blob/main/docs/CONTRIBUTING.md) · [简体中文](/cosyncing/cosyncing/blob/main/README.zh-CN.md) Synchronize and control your agents — from CLI to GUI, from desktop to phone. Pick up right where you left off, anywhere. cosyncing keeps your coding agents in sync across your own network. The broker runs on the machine where your agents work. It watches their sessions and serves a client that shows each one — grouped by project, with its transcript, diffs, commands, and any prompt waiting on you. Read a session, answer a prompt, or take over. No account to create, no hosted service between the client and the broker. One protocol covers all six. Per-agent control differs, and Claude Code sessions open read-only until you take over. See [supported-agent setup](/cosyncing/cosyncing/blob/main/docs/supported_agents/README.md) for versions and installation, and [adapter support](/cosyncing/cosyncing/blob/main/docs/protocol/adapter-support.md) for the capability matrix. Foreground clients can join the same broker-owned Codex or Pi Drive session without starting a second native Resume. Claude Code keeps its Observe/Take-over flow on another client, while OpenCode keeps its shared-live behavior. Background Observe connections stay read-only. **Experimental:** Two provisional adapters are available to source contributors, both talking to a local server rather than a CLI. [Kimi Code](/cosyncing/cosyncing/blob/main/docs/supported_agents/kimi.md) observes every session on a `kimi web` server read-only, drives the ones cosyncing created — prompts, approvals, model selection — and takes over the ones it did not, explicitly. [DeepSeek Harness](/cosyncing/cosyncing/blob/main/docs/supported_agents/dsh.md) connects to a `dsh web` host and gives active foreground clients a shared transcript and control surface, with model and reasoning-effort selection, permission presets, the host's own slash commands, and image attachments. General file attachments are not supported — the host accepts image content only — and background resident subscriptions and some message presentation remain follow-up work. Neither needs a rollout flag, and neither needs a terminal left open: an installed cosyncing service starts a host when none is running, restarts one that crashes, and stops the one it started. A host you started yourself is never stopped, replaced, or reconfigured, and setup names both hosts before you agree to manage them. Install DeepSeek Harness globally with `npm install -g @deepseek-ai/dsh` — cosyncing looks for `dsh` on your PATH, so an `npx` -only install can be talked to but never started or version-checked. See [supported-agent setup](/cosyncing/cosyncing/blob/main/docs/supported_agents/README.md) for both hosts. Supported cross-device use requires [Tailscale](https://tailscale.com/) on the server and client devices. The server requires [Bun](https://bun.sh) 1.3.8 or newer to run cosyncing and Node.js/npm to install and update it. [Tokdash](https://github.com/JingbiaoMei/tokdash) is optional but strongly recommended for quota tracking and warnings. See [installation prerequisites](/cosyncing/cosyncing/blob/main/docs/installation/prerequisites.md) for Linux and macOS commands, WSL notes, and Tokdash setup. The package contains one JavaScript application bundle and the web client. Supported broker hosts are Linux x64, Linux arm64, and Apple Silicon macOS; on Windows, run the broker inside WSL. Before setup, install only the agents you use; see [agent setup and PATH preflight](/cosyncing/cosyncing/blob/main/docs/supported_agents/README.md#preflight). Install the current release: ``` npm install --global cosyncing ``` Open a new login shell, then configure the service: ``` cosyncing setup # After setup, use cosy as the shorthand for cosyncing cosy restart cosy doctor cosy status cosy pair ``` `setup` inspects the machine, shows exactly what it will change, and applies the whole plan or none of it. It copies the broker to `~/.cosyncing/bin/cosyncing` , installs a user service that runs that copy with your Bun, and prints your broker URL. The broker refuses to start until setup has committed. To update, let npm replace the global package, then re-run setup so cosyncing copies the new application into its managed service and reconciles the installation: ``` npm update --global cosyncing cosy setup ``` `cosy update` reports this package-manager-owned update path; it does not run npm or modify the global package. `cosy pair` prints a five-minute, one-use QR code. Scan it from a client to grant that device access; `cosy devices list` lists paired devices, and `cosy devices revoke ` revokes one. After setup, `cosy doctor` diagnoses the machine without changing it, and `cosy status` summarizes install, service, agents, and sessions. The packaged Flutter web app is served by your own broker at `/cosy/` ; it does not fetch application code from a third-party host at runtime. Setup prints the URL; open it in any browser that can reach the broker. Android and desktop clients are available from [GitHub Releases](https://github.com/cosyncing/cosyncing/releases/latest). The iOS client will follow later through TestFlight. **Server** — the broker runs on: **Clients** — the source tree and CI cover six platforms: Native Windows and Intel macOS server hosting are not supported in this release. On Windows, run the broker inside WSL, where it is a supported Linux host; install Tailscale inside WSL too, since Windows-host Tailscale cannot proxy WSL loopback. The broker runs on your machine, under your account. Broker state is stored there; session content is sent only to authenticated clients over the network you choose. cosyncing operates no hosted service in that connection path and includes no analytics or advertising telemetry. Optional features contact only the services they name, such as Tailscale Serve and local Tokdash quota data. The npm-installed broker does not silently replace itself: npm owns package updates, and `cosy setup` reconciles the installed service after an update. Report vulnerabilities through GitHub private vulnerability reporting, per [SECURITY.md](/cosyncing/cosyncing/blob/main/SECURITY.md). `packages/typescript/` — broker, wire-contract owner, agent adapters, transport, and crypto.`packages/dart/` — client contract, transport, Flutter adapter, and crypto.`apps/client/` — the Flutter application, including every platform runner, test suite, integration driver, and developer tool.`contracts/generated/` — broker-owned, flattened client contract snapshot.`apps/poc-ui/` — non-production proof-of-concept UI retained for deterministic broker tests. The repository pins Flutter 3.44.3 in `.fvmrc` and Bun 1.3.8 in `package.json` . Run commands from the repository root. ``` bun install --frozen-lockfile bun run client:pub-get bun run typecheck bun run client:analyze bun run client:test ``` Regenerate broker-owned client contracts with `bun run contract:generate` . CI runs `bun run contract:check` and fails on a stale snapshot. Start with [docs/README.md](/cosyncing/cosyncing/blob/main/docs/README.md) and [build and test](/cosyncing/cosyncing/blob/main/docs/development/build-test.md). Read [CONTRIBUTING.md](/cosyncing/cosyncing/blob/main/docs/CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](/cosyncing/cosyncing/blob/main/docs/CODE_OF_CONDUCT.md) before opening a change; contributions use fork-and-pull-request and require a signed-off commit. Usage questions go to GitHub Discussions and reproducible defects to GitHub Issues — see [SUPPORT.md](/cosyncing/cosyncing/blob/main/docs/SUPPORT.md). Installs from a predecessor client start fresh; see [local data and upgrades](/cosyncing/cosyncing/blob/main/docs/development/data-and-upgrades.md). First-party source is licensed under the Apache License 2.0. See [LICENSE](/cosyncing/cosyncing/blob/main/LICENSE) and [NOTICE](/cosyncing/cosyncing/blob/main/NOTICE).