dsh-plugin-coaligne
[中文](./README.zh.md)
Bring your team's shared <https://www.coaligne.com> project context into DeepSeek Harness.
CoAligne is a collaboration platform where teammates and their Agents share project context. CoAligne Desktop syncs local project files and Agent conversations into a cloud project, and connects your local agents — including DSH — to that cloud context.
What you get
- The
coaligne-workflowskill, installed into your agents home at plugin activation (skills/under$DSH_AGENTS_HOME, default.agentsin your home directory): teaches the agent when and how to use the CoAligne tools — collaboration queries, long-content search strategy, comment replies, sharing flows, and a single-project AI usage report. - CoAligne MCP tools, once CoAligne Desktop is connected (see Setup below; tools appear as
mcp__coaligne__<tool>):
- list_projects, me, get_project_activity — project discovery and recent activity - search — sandboxed read-only shell (grep, cat, find, …) over synced files and Agent session logs - download_file, list_file_comments, reply_file_comment — file downloads and comment threads - create_file_link, resolve_file_link, resolve_session_link — private app.coaligne.com/f/{code} and app.coaligne.com/s/{code} locator links - list_project_reviewers, create_review_request — send a file or Agent session to a teammate
Setup
1. Install this plugin (or one-click install from dsh-market):
``bash npm install dsh-plugin-coaligne ``
2. Sign up at <https://www.coaligne.com>.
3. Install CoAligne Desktop (macOS and Windows) from <https://www.coaligne.com>, sign in, and import your local project. Desktop then does two things for you: - Sync: keeps your project files and Agent sessions flowing into the cloud project your team shares. - Connect: automatically configures the CoAligne MCP connection for DSH (a @deepseek-ai/dsh-mcp-client row with serverName coaligne and your account credentials). No manual token handling.
That's it — restart your DSH session and the mcp__coaligne__* tools are available, with the skill guiding when to use them.
> Without CoAligne Desktop this plugin is not usable: it only installs the workflow skill, and the skill's tools all come from the Desktop-provisioned MCP connection. The plugin logs an explicit warning at activation when no Desktop connection is found.
What the bundle patch adds
The bundle patch (cordis.patch.yml) composes two rows into your profile:
| Row | Package | Purpose |
|---|---|---|
coaligne-skill | dsh-plugin-coaligne | Installs the bundled coaligne-workflow skill into $DSH_AGENTS_HOME (default: .agents in your home directory) |
coaligne-skill-invariant | dsh-plugin-coaligne/invariant | Package-owned invariant companion |
The MCP connection is deliberately not declared here — CoAligne Desktop provisions and maintains it, so this package never sees or stores credentials.
Configuration
The coaligne-skill row accepts:
| Option | Default | Description |
|---|---|---|
installSkill | true | Install/refresh the bundled skill at activation |
agentsHome | '' | Override the agents home; empty resolves $DSH_AGENTS_HOME, then .agents in the home directory |
How it works
- The skill install is an idempotent copy at plugin activation; disable it with
installSkill: falseif you manage skills yourself. - The MCP connection is owned by CoAligne Desktop: it signs in with your account, writes the connection for DSH, and keeps it valid. This plugin contains no credentials and makes no network calls.
Development
pnpm install
pnpm typecheck
pnpm test
pnpm buildLicense
[BSD-3-Clause](./LICENSE). Scaffolded from <https://github.com/omdsh-dev/plugin-template>.