> This repository has moved into one monorepo.
>
> The BornCode plugins — agent customization, desktop control, auto-continue,
> auto-shutdown, browser use, session instructions, session sync, and the side
> chat — now live in
> borncode-app/dsh-borncode,
> one repository with one Plugins entry.
>
> | this repo | new home |
> |---|---|
> | dsh-agent-customizer | packages/dsh-agent-customizer |
> | dsh-agent-desktop | packages/dsh-agent-desktop |
> | dsh-auto-continue | packages/dsh-auto-continue |
> | dsh-auto-shutdown | packages/dsh-auto-shutdown |
> | dsh-browser-use | packages/dsh-browser-use |
> | dsh-session-instructions | packages/dsh-session-instructions |
> | dsh-session-sync | packages/dsh-session-sync |
> | dsh-side-chat | packages/dsh-side-chat |
>
> The code and its history are unchanged; only the repository is shared. Install
> dsh-borncode instead of the individual bundles. This repository stays open
> so the old links keep working.
dsh-agent-desktop
Native computer use for DeepSeek Harness — the agent sees and drives the real desktop.
What it does
agent-desktop is a CLI that reads the operating system's
accessibility tree and acts on it — no screenshots, no pixel matching. This plugin owns that binary for you:
- installs it into
~/.dsh/agent-desktop//on first use, - checks for a newer release on every Harness launch and swaps it in,
- exposes its commands as first-class tools the model can call,
- and shows both on a Settings page.
Result: "open the calculator and type 42" works without a terminal round trip.
Features
- Install-on-demand — the right release for your platform is fetched, checksum-verified, and cached.
- Auto-update —
autoUpdate: truekeeps the binary current; disable it to pin the version you have. - First-class tools —
desktop_snapshot,desktop_find,desktop_click,desktop_set_value,
desktop_press,desktop_wait,desktop_screenshot, and friends, with refs instead of coordinates. - Operating guide in the prompt —
guideInPromptteaches the model the observe → act → observe loop,
so it does not guess element positions. - Settings page — installed version, update state, and the guide, all visible in the GUI.
- Bounded calls —
toolTimeoutMsstops a hung window from stalling the turn.
Requirements
| DeepSeek Harness | 0.2.x (Web GUI) |
| Runtime | Node 24, supplied by the Harness runtime |
| Platform | Wherever agent-desktop ships a release (Windows, macOS, Linux) |
| OS permission | Accessibility / automation permission for the app hosting DSH |
> The first desktop_* call on macOS asks for Accessibility permission. Deny it and every tool answers
> with an error rather than silently doing nothing.
Install
git clone https://github.com/borncode-app/dsh-agent-desktop.git dsh-agent-desktop
Then, in DSH: Plugins → install the bundle from that directory, or:
plugin_manager install_bundle target=C:\path\to\dsh-agent-desktop
Restart once. The binary installs itself on the first desktop_* tool call.
Configuration
| field | default | meaning |
|---|---|---|
endpoint |
/plugins/agent-desktop |
Path the Web GUI reads and writes plugin data at |
autoUpdate |
true |
Check GitHub for a newer release on every Harness launch |
repo |
vercel-labs/agent-desktop |
Upstream repository the release and checksums come from |
registerTools |
true |
Register the desktop_* tools the model calls |
guideInPrompt |
true |
Add the operating guide to the model's system prompt |
toolTimeoutMs |
60000 |
Longest one desktop command may run, in milliseconds |
How it works
tool call ──▶ plugin host row ──▶ agent-desktop CLI ──▶ OS accessibility tree
│ │
└── install / update release ◀── GitHub ─┘
The plugin never synthesizes keystrokes itself: it shells out to the CLI and returns the CLI's JSON, so the
action semantics and the permission model stay in one place, upstream.
Files
| file | role |
|---|---|
index.js |
host row: release resolution, install/update, tool registration, Settings page |
client.js |
the Settings page |
cordis.patch.yml |
the bundle patch that inserts the row |
locale/{en,th,zh}.json |
UI strings |
icon.svg |
plugin icon |
Safety
Computer use is real: a click lands where the model points it. Keep access mode at approve while you build
trust, leave autoUpdate on so security fixes land, and remember that the tools act as you on this machine.
ภาษาไทย
Plugin นี้ให้ agent ควบคุมเครื่à¸à¸‡à¸ˆà¸£à¸´à¸‡ ผ่าน CLI agent-desktop
ขà¸à¸‡ Vercel Labs — à¸à¹ˆà¸²à¸™ accessibility tree ขà¸à¸‡ OS à¹à¸¥à¹‰à¸§à¸ªà¸±à¹ˆà¸‡à¸‡à¸²à¸™ ไม่ใช่à¸à¸²à¸£à¸ˆà¸±à¸šà¸ าพหน้าจà¸
- ติดตั้งไบนารีเà¸à¸‡à¹ƒà¸™
~/.dsh/agent-desktop/ครั้งà¹à¸£à¸à¸—ี่เรียà¸à¹ƒà¸Šà¹‰ à¹à¸¥à¸°à¸à¸±à¸›à¹€à¸”ตà¸à¸±à¸•โนมัติทุà¸à¸„รั้งที่เปิด DSH - เพิ่ม tool
desktop_*ให้โมเดลเรียà¸à¹„ด้ (snapshot / find / click / set_value / press / wait / screenshot) - ใส่ "คู่มืà¸à¸à¸²à¸£à¹ƒà¸Šà¹‰à¸‡à¸²à¸™" ใน system prompt ด้วย (
guideInPrompt: true) - มีหน้า Settings ให้ดูเวà¸à¸£à¹Œà¸Šà¸±à¸™à¸—ี่ติดตั้งà¹à¸¥à¸°à¸ªà¸–านะà¸à¸±à¸›à¹€à¸”ต
âš ï¸ à¹€à¸„à¸£à¸·à¹ˆà¸à¸‡à¸¡à¸·à¸à¸™à¸µà¹‰à¸—ำงานà¹à¸—นคุณบนเครื่à¸à¸‡à¸ˆà¸£à¸´à¸‡ — ช่วงà¹à¸£à¸à¸„วรตั้ง access mode เป็นà¹à¸šà¸šà¸‚à¸à¸à¸™à¸¸à¸¡à¸±à¸•ิà¸à¹ˆà¸à¸™
License
MIT © 2026 BornCode