dsh-plugin-coaligne

Readme

# 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-workflow` skill**, installed into your agents home at plugin activation (`skills/` under `$DSH_AGENTS_HOME`, default `.agents` in 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

![CoAligne Desktop: team projects synced from local Agent workspaces](docs/screenshots/coaligne-desktop-team-projects.png)

## 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: false` if 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

```bash
pnpm install
pnpm typecheck
pnpm test
pnpm build
```

## License

[BSD-3-Clause](./LICENSE). Scaffolded from <https://github.com/omdsh-dev/plugin-template>.