cinderzhan / dsh-plugin-coaligne

dsh-plugin-coaligne

中文

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; this plugin connects a DSH agent to that cloud context.

What you get

• CoAligne MCP tools (via the official @deepseek-ai/dsh-mcp-client, streamable-http):
  • 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
• coaligne-workflow skill, installed into your agents home (skills/ under $DSH_AGENTS_HOME, default .agents in your home directory): teaches the agent when and how to use those tools — collaboration queries, long-content search strategy, comment replies, sharing flows, and a single-project AI usage report.

Prerequisites

1. A CoAligne account — sign up at https://www.coaligne.com.
2. A CoAligne access token (ca_...) from your account settings at https://app.coaligne.com.
3. To sync your own projects into the cloud: CoAligne Desktop, signed in, with your project imported.

Install

Install the package and list it in your DSH profile bundles (or use dsh-market):

npm install dsh-plugin-coaligne

The bundle patch (cordis.patch.yml) composes three rows into your profile:

Row	Package	Purpose
coaligne	dsh-plugin-coaligne	Installs the bundled coaligne-workflow skill into $DSH_AGENTS_HOME (default: .agents in your home directory)
coaligne-invariant	dsh-plugin-coaligne/invariant	Package-owned invariant companion
coaligne-mcp	@deepseek-ai/dsh-mcp-client	Streamable-HTTP MCP connection to https://app.coaligne.com/mcp

Then set your token in the coaligne-mcp row:

headers:
  Authorization: 'Bearer ca_your_token_here'

Configuration

The coaligne 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 MCP connection is declarative: a config row for the host's own MCP client, no extra runtime code, tools appear as mcp__coAligne__<tool>.
• The skill install is an idempotent copy at plugin activation; disable it with installSkill: false if you manage skills yourself.
• Your token only ever goes to app.coaligne.com as a Bearer header on MCP requests.

Development

pnpm install
pnpm typecheck
pnpm test
pnpm build

License

BSD-3-Clause. Scaffolded from https://github.com/omdsh-dev/plugin-template.