tomilite-dsh-plugin

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

Tool	Description
tomilite_list_tasks	List tasks, optional status filter (todo / in_progress / done). Returns compact rows (description truncated to 300 chars)
tomilite_create_task	Create a task (title, description, type, priority, story points)
tomilite_update_task	Update status / priority / description
tomilite_list_notes	List knowledge-base notes, optional category filter. Returns compact rows (content preview truncated to 500 chars)
tomilite_create_note	Create a Markdown note
tomilite_get_stats	Board statistics — counts per status / priority / type — handy before writing daily reports

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 [email protected].
• GitHub topic: dsh-plugin (for plugin ecosystem discovery)

License

MIT © 2026 Tomatovector