# Install the MixShift plugin

The plugin installs from the MixShift catalog on GitHub. Pick the path that matches how you use Claude; each takes a few minutes, and every path ends the same way: you sign in once and start asking questions about your data.

## Which path is right for me?

- **You use the Cowork desktop app on your own.** Follow the Cowork steps below.
- **Your team uses Cowork and you want everyone to have it.** An org admin publishes it once. See [Install for your whole team](/knowledge-base/plugin/how-to/install-for-your-whole-team).
- **Your company manages Claude centrally (Team or Enterprise plan).** Your Claude admin adds it through the admin console. See the admin console note below.
- **You use Claude Code** (the terminal or desktop app). Two commands, below.
- **You want the MixShift CLI without Claude.** See the CLI note at the bottom.
- **You use claude.ai in a browser, or the Claude Desktop app.** The plugin does not install there. Connect MixShift as an MCP connector instead and you get the same data in chat, without the packaged skills: see [Connect AI tools over MCP](/knowledge-base/builder-platform/how-to/connect-ai-tools-over-mcp).

We recommend the **stable channel** for everyone. It is the tested release cut; installs that skip it track the newest changes before they are announced.

## Before you start

- An active MixShift account. You sign in with your MixShift work email.
- Node.js version 20 or newer on your computer. To check, open a terminal and run `node --version`.

## Install in Cowork (personal)

1. In Cowork, click **Customize** in the left sidebar.
2. Click the **+** button and choose **Add marketplace from GitHub**.
3. Paste `https://github.com/miXshift/mx-claude-plugin/tree/stable` and confirm. This registers the MixShift catalog on your seat only.
4. Open the **Directory** view (Skills / Connectors / Plugins under Customize).
5. Find **mixshift-ai** in the plugin list and click **Install**.
6. In the same view, turn on **Sync automatically** for the MixShift marketplace so you keep getting updates.

The plugin appears under **Personal plugins** in your sidebar.

## Install in Claude Code

Run these two commands inside Claude Code:

1. `/plugin marketplace add https://github.com/miXshift/mx-claude-plugin.git#stable`
2. `/plugin install mixshift-ai@mixshift`

Use the full address with `#stable` as written; short forms pin you to the wrong channel.

## Company-wide installs

- **Cowork organization:** an org admin publishes the plugin once from Organization settings and every seat gets it. See [Install for your whole team](/knowledge-base/plugin/how-to/install-for-your-whole-team).
- **Claude admin console (Team and Enterprise plans):** your Claude admin uploads the MixShift marketplace zip from the GitHub Releases page, or points a private mirror repository at our stable channel so updates flow automatically. Ask us if your admin wants a hand; this path takes minutes.

## CLI without Claude

Builders and scripts can use the bundled `mixshift` command line directly: clone the repository, then build the harness (`npm install` and `npm run build` inside the harness folder) and put `harness/bin/mixshift` on your PATH. This needs `git` and Node 20 or newer. Most people do not need this path; the plugin installs the CLI for you.

## Next

Sign in and try your first question: [Sign in to MixShift](/knowledge-base/plugin/getting-started/sign-in).