kivotos

Kivotos

English · 简体中文 · 日本語 · 한국어

Every DeepSeek Harness you run, from any computer or your phone.

Kivotos is an open source plugin for DeepSeek Harness (dsh). Open any of your machines' dsh from any other, with its full UI: sessions, approvals, models, settings, files, and terminal. It adds a phone layout to dsh and comes with an Android app.

• All your machines: Switch between them from the dsh sidebar. What you see is the remote dsh's own UI, so everything works.
• Two ways to connect: Tailscale, or a relay server you run yourself. A machine can use both at once.
• Untrusted relay: The relay only forwards end-to-end encrypted data. It cannot read it or join your network.
• Phone layout: Drawer sidebar, composer at the bottom, safe areas, light and dark.
• Android app: The full dsh UI, with notifications for approvals, questions, and finished tasks.
• Self-hosted: No account, no telemetry, no push service.

Getting Started

Prerequisites

• DeepSeek Harness 0.2.1-rc.2
• Tailscale signed in to the same account on every device, or your own relay server

Plugin

Install it on every machine. In dsh, open Plugins → Install a third-party plugin and enter kivotos. Or from the terminal:

dsh plugin --profile web add kivotos

Restart dsh. Your other machines appear under Machines at the bottom of the sidebar.

Phone

Install the APK from the releases page. On the computer, open Machines → Pair phone and scan the code in the app.

Relay

Run the relay with Docker Compose on a server with a public address:

curl -O https://raw.githubusercontent.com/Rinai-R/kivotos/main/packages/relay/docker-compose.yml
docker compose up -d

On the first computer, open Settings → Remote access → Own relay, enter the relay's address, and create a network. Register it on the relay by running the command the page shows after docker compose exec relay. Other computers and phones join with the invite link or its QR code.

Anyone with the invite link, or signed in to your Tailscale account, has full control of your machines.

Development

• packages/kivotos: the dsh plugin (TypeScript)
• packages/mobile: the Android app (Expo, Kotlin)
• packages/relay: the relay server (Go)

npm install          # install tools and build the plugin
npm run build        # rebuild the plugin after changing src/
npm run typecheck
npm test

npm run apk -w packages/mobile     # Android APK (JDK 17, Android SDK)
cd packages/relay && go test ./...

See CONTRIBUTING.md to build, test and contribute, and npm run dev to start a relay and two dsh instances locally. Architecture and conventions are in AGENTS.md; report vulnerabilities through SECURITY.md.

License

Apache-2.0. Kivotos is not affiliated with DeepSeek or Tailscale.