tomilite-dsh-plugin

A DeepSeek Harness plugin that gives your DSH agent access to your local TomiLite — tasks, notes, and project stats.

The agent creates a task in TomiLite and it shows up in your Tasks panel instantly. Your DSH agent becomes the hands, TomiLite stays the workspace.

🚀 Get TomiLite

This plugin needs the TomiLite desktop app running on the same machine.

Windows one-liner (skips install if TomiLite is already running, otherwise downloads + installs + starts it):

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/xxwj225-James/tomilite-dsh-plugin/main/scripts/install-tomilite.ps1 | iex"

Or download the installer manually: TomiLite Releases

If TomiLite is not running, the tools fail with an actionable message (with the download link) — the agent will relay it to you.

Prerequisites

• DeepSeek Harness installed (npx @deepseek-ai/dsh web, or built from source)
• TomiLite desktop app running — the plugin talks to its local API at http://localhost:3192 (localhost calls are token-exempt; no API key needed)
• Node.js 22.19+ (matches DSH requirements)

Install

# npm (recommended once published)
dsh plugin --profile web add tomilite-dsh-plugin

# git (installs from this repository)
dsh plugin --profile web add github:xxwj225-James/tomilite-dsh-plugin

# local checkout
dsh plugin --profile web add ./tomilite-dsh-plugin

Restart the DSH web UI (or dsh CLI) after installing.

Configuration

Defaults work out of the box for the local TomiLite app. Override in your profile's cordis.patch.yml:

- id: tomilite
  name: tomilite-dsh-plugin
  config:
    baseUrl: http://localhost:3192   # default
    apiToken: ''                     # only for remote instances (Settings → API Keys)
    projectId: proj-default          # default single-user project

apiToken can also come from the TOMILITE_API_TOKEN environment variable. For remote instances prefer HTTPS — the token travels in plain HTTP otherwise.

Tools

If TomiLite is not running, tools fail with an actionable message (the agent will tell you to start TomiLite). Every HTTP call carries a 15-second timeout so a hung TomiLite never stalls an agent turn.

How it works

The plugin is a host-side Cordis plugin that speaks the same tRPC wire format as TomiLite's own web frontend (apps/web/src/lib/api.ts):

• Reads: GET /api/<router>.<procedure>?input=<urlencoded JSON>
• Mutations: POST /api/<router>.<procedure> with a JSON body
• Responses: tRPC envelope { result: { data: ... } }
• Auth: x-tl-token header, only needed for non-localhost instances

The tools registered by this plugin (ctx.tools.register + defineTool from @deepseek-ai/dsh-tools) become regular model-visible tools — schemas are enforced before execute runs, results are rendered as compact JSON blocks.

Language

Tool descriptions and result messages are in English. DSH's locale service is browser-side only, so host-side tool plugins (including every official DSH tool package) ship static English copy; translations can be added once DSH exposes a host-side locale.

Development

npm install
npm run build                 # tsc → lib/
npm test                      # smoke + real-Cordis load tests (no network)
npm run test:integration      # round-trips against a RUNNING TomiLite on :3192

• test/smoke.mjs — registration + model-surface checks with a mock context (no network)
• test/cordis-load.mjs — boots a real @deepseek-ai/cordis context, loads the plugin through ctx.plugin(), verifies inject resolution, tool registration, and Config-schema rejection of invalid config (no network)
• test/integration.mjs — live round-trips against a running TomiLite; creates and deletes its own rows, no user data touched

lib/ is committed so git installs work without a build step; CI rebuilds it to guarantee freshness (npm run build before committing).

Notes

• DeepSeek Harness is in developer preview (rc releases) and may break plugin APIs between releases; this plugin is pinned to dsh-tools@0.1.0-rc.7.
• GitHub topic: dsh-plugin (for plugin ecosystem discovery)

License

MIT © 2026 Tomatovector