# Install matrix
Source: https://docs.treeship.dev/integrations/install

> One-liner install command per agent, plus the bypass-proof plugin where available.

# Install matrix

This page is generated from [`integrations/agents.json`](https://github.com/zerkerlabs/treeship/blob/main/integrations/agents.json) — the single source of truth for every Treeship integration. Machine-readable mirror: [`/.well-known/treeship-agents.json`](/.well-known/treeship-agents.json).

<Callout type="info">
  Tier definitions (`release_status`):

  * **🟢 shipped** — installable and end-to-end verified today.
  * **🟡 candidate** — works via the documented install, vendor marketplace submission pending.
  * **⚪ unavailable** — this tier does not exist because the agent's runtime does not expose the required surface.
</Callout>

## The matrix

| Agent             | Skill                                                                        | MCP                                                                                                      | Plugin (hook-based)                                                                            | Plugin status |
| ----------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------- |
| **Claude Code**   | `treeship add claude-code`                                                   | `treeship add claude-code`                                                                               | `claude plugin marketplace add zerkerlabs/treeship && claude plugin install treeship@treeship` | 🟢 shipped    |
| **OpenClaw**      | `treeship add openclaw`                                                      | `treeship add openclaw`                                                                                  | `openclaw plugins install @treeship/openclaw-plugin`                                           | 🟢 shipped    |
| **Codex CLI**     | `treeship add codex`                                                         | `treeship add codex`                                                                                     | `npx skills add zerkerlabs/treeship --skill treeship-dev --agent codex -g -y`                  | 🟡 candidate  |
| **Kimi Code CLI** | `npx skills add zerkerlabs/treeship --skill treeship --agent kimi-cli -g -y` | `kimi mcp add --transport stdio treeship --env TREESHIP_ACTOR=agent://kimi-code -- npx -y @treeship/mcp` | `treeship integrations install kimi-code`                                                      | 🟡 candidate  |
| **Cursor**        | `treeship add cursor`                                                        | `treeship add cursor`                                                                                    | —                                                                                              | ⚪ unavailable |
| **Hermes**        | `treeship add hermes`                                                        | `see integrations/hermes/README.md (yaml config with TREESHIP_ACTOR=agent://hermes)`                     | —                                                                                              | ⚪ unavailable |

## What each tier means

* **Skill** — drops a `SKILL.md` instruction file into the agent's skills directory. The agent reads it and follows the instructions to call `treeship` CLI commands. **Bypass-able by prompt injection** — the same agent being attested is the one deciding whether to attest.
* **MCP** — exposes Treeship as MCP tools the agent can call. Captures every MCP-routed tool call automatically. Stronger than skill alone (no agent discipline required for MCP-routed work) but doesn't cover the agent's built-in non-MCP tools.
* **Plugin (hook-based)** — runs *below* the agent in the host process. Pre/post-tool-call hooks fire regardless of what the agent says, remembers, or has been prompt-injected to do. **Bypass-proof.** This is the integrity gold standard.

## Run it from anywhere

```bash
curl -fsSL treeship.dev/setup | sh
treeship init
treeship add       # detects and instruments every supported agent on this machine
```

Or pick one:

* `treeship add claude-code`
* `treeship add openclaw`
* `treeship add codex`
* `treeship add cursor`
* `treeship add hermes`

## Partnership track

Surfaces where the vendor controls the runtime and a third-party plugin is not currently possible:

* **Kimi (web / kimi.com)** (Moonshot AI) — *no\_public\_surface*. No public third-party plugin SDK. Skills on kimi.com are user-uploaded docs, not executable code.
* **Kimi (iOS / Android)** (Moonshot AI) — *no\_public\_surface*
* **Kimi Agent Swarm (K2.6+)** (Moonshot AI) — *api\_only*. OpenAI-compatible API at platform.moonshot.ai. No hook-injection below the model's instruction surface.
* **Perplexity Computer / Comet** (Perplexity) — *partner\_shipping*. Perplexity shipping the official Treeship Computer skill (per founder, May 2026). Receipt agent\_name: perplexity-computer.
* **Perplexity Pro Search** (Perplexity) — *no\_public\_surface*. First-party Connectors only; no third-party connector SDK.