dsh-deeppilot

dsh-deeppilot

English | 简体中文

The open-source DSH companion plugin for DeepPilot, a native iPhone client for using DeepSeek Harness remotely. It connects the app directly to the DSH Host on your own Mac and does not replace or modify the DSH Web UI.

DeepPilot is currently in TestFlight review. The invitation link will accept testers after Apple approves the build.

Join the DeepPilot TestFlight

What you get

• Browse projects, sessions, history, and live agent output from iPhone.
• Send prompts, switch models, create sessions, and answer approvals/questions.
• Pair through a QR code with the secret stored on the Mac and in iOS Keychain.
• Connect over a trusted LAN or the optional embedded Tailscale Funnel.
• Receive live notifications and optional APNs notifications while offline.

Install from npm

Requirements: Node.js 22+, a DSH web profile, and macOS. The bundled Funnel helper currently supports Apple silicon; trusted-LAN mode does not require it.

dsh plugin --profile web add dsh-deeppilot
dsh web

After DSH restarts, open Settings → DeepPilot, enable the connection, show the pairing QR code, and scan it in the DeepPilot app.

Package: npmjs.com/package/dsh-deeppilot

Update or uninstall

dsh plugin --profile web update dsh-deeppilot
dsh plugin --profile web remove dsh-deeppilot

Restart DSH after updating. Uninstalling the package does not delete the local DeepPilot state under $DSH_HOME/deeppilot/.

Connection and privacy

Conversation traffic travels directly between the iPhone and your DSH Host. Trusted-LAN ws:// traffic is unencrypted, so use it only on a network you trust. Optional Funnel mode exposes only the authenticated DeepPilot connection and health endpoints, not the complete DSH Web UI.

Offline push is optional. Relay mode sends only the target APNs device token and a limited notification payload; full conversation history and live output do not pass through the relay. Read PRIVACY.md and SECURITY.md before enabling remote access or push.

Screenshots

Home	Sidebar	Chat	Settings

Compatibility

See COMPATIBILITY.md for the tested baseline and current limitations. DSH is still evolving; include exact DSH and plugin versions when reporting an issue.

Protocol

PROTOCOL.md is the normative DeepPilot bridge protocol. Any wire change must update that document and src/protocol.ts together, preserve protocol-v1 compatibility, and be coordinated with the private iOS client.

Development

npm ci
npm test
npm run typecheck
npm run build
cd helper && go test ./...

Community and feedback

• GitHub Issues
• GitHub Releases
• npm package

DeepPilot is an independent community project and is not affiliated with or endorsed by DeepSeek.

License

MIT — see LICENSE.