cubic Plugin for Claude Code

Access cubic's AI code review insights directly from Claude Code. Get PR review issues, browse AI-generated wikis, check codebase scans, and apply team review learnings — all without leaving your editor.

Claude Code Install

/plugin marketplace add mrge-io/cubic-claude-plugin
/plugin install cubic@cubic

Requires Claude Code v1.0.33+

CLI Install

# All targets (default)
npx @cubic-plugin/cubic-plugin install

# Claude Code
npx @cubic-plugin/cubic-plugin install --to claude

# OpenCode
npx @cubic-plugin/cubic-plugin install --to opencode

# Codex
npx @cubic-plugin/cubic-plugin install --to codex

# Cursor
npx @cubic-plugin/cubic-plugin install --to cursor

# Factory Droid
npx @cubic-plugin/cubic-plugin install --to droid

# Pi
npx @cubic-plugin/cubic-plugin install --to pi

# Gemini CLI
npx @cubic-plugin/cubic-plugin install --to gemini

The installer will prompt you for your API key during setup.

To uninstall, use the same --to flag:

npx @cubic-plugin/cubic-plugin uninstall --to opencode

Prerequisites

• Claude Code v1.0.33+
• A cubic account with an active installation
• A cubic API key (cbk_*)
• (Optional) cubic CLI for /cubic:run-review

Installation

From GitHub (recommended)

# Step 1: Add the cubic marketplace
/plugin marketplace add mrge-io/cubic-claude-plugin

# Step 2: Install the plugin
/plugin install cubic@cubic

Requires Claude Code v1.0.33+

Team Auto-Install

To make cubic automatically available for all team members in a repository, add this to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "cubic": {
      "source": {
        "source": "github",
        "repo": "mrge-io/cubic-claude-plugin"
      }
    }
  },
  "enabledPlugins": {
    "cubic@cubic": true
  }
}

When team members open the project in Claude Code and trust the repository, they'll be prompted to install the plugin.

Setup

The installer will prompt you for your API key during npx @cubic-plugin/cubic-plugin install. It opens your browser to the cubic dashboard where you can generate a key, then you paste it in the terminal. The key is saved directly into the MCP configuration.

You can also set CUBIC_API_KEY in your environment and the installer will detect it automatically.

Tip: In Claude Code, you can also just say "set up my cubic key" and paste your key — the env-setup skill will detect your OS and shell and save it automatically.

Commands

| Command | Description | | -------------------------------- | ---------------------------------------------------------------------- | | /cubic:comments [pr-number] | Show cubic's review comments on the current PR (auto-detects branch) | | /cubic:run-review [flags] | Run a local cubic AI code review on uncommitted changes or branch diff | | /cubic:wiki [page-name] | Browse AI-generated codebase documentation | | /cubic:scan [scan-id] | View codebase security scan results and issues | | /cubic:learnings [learning-id] | Show team code review patterns and preferences |

Skills (Auto-triggered)

These activate automatically based on what you're doing:

| Skill | Triggers when | What it does | | ---------------------- | ---------------------------------------------- | ------------------------------------------------------------------ | | review-and-fix-issues | Working on a PR branch, fixing review comments | Fetches all cubic issues, investigates each, and reports which are worth fixing | | run-review | "Review my code", pre-commit/PR quality checks | Runs a local cubic AI code review via CLI and surfaces issues | | codebase-context | Asking about architecture or how things work | Queries the cubic AI Wiki for architectural context | | review-patterns | Writing or reviewing code | Pulls team learnings to apply coding conventions | | env-setup | Setting up cubic, pasting an API key | Detects OS and shell, persists API key to shell config |

MCP Tools

The plugin connects to cubic's MCP server, giving Claude access to 9 tools:

Wiki: list_wikis, list_wiki_pages, get_wiki_page Codebase Scans: list_scans, get_scan, get_issue Review Learnings: list_learnings, get_learning PR Reviews: get_pr_issues

Plugin Structure

cubic-claude-plugin/
├── .claude-plugin/
│   ├── marketplace.json   # Marketplace catalog for distribution
│   └── plugin.json        # Plugin metadata
├── .mcp.json              # cubic MCP server configuration
├── commands/
│   ├── comments.md        # /cubic:comments command
│   ├── run-review.md      # /cubic:run-review command (CLI)
│   ├── wiki.md            # /cubic:wiki command
│   ├── scan.md            # /cubic:scan command
│   └── learnings.md       # /cubic:learnings command
├── skills/
│   ├── review-and-fix-issues/ # Fetches, investigates, and triages PR review issues
│   │   └── SKILL.md
│   ├── run-review/        # Runs local AI code review via cubic CLI
│   │   └── SKILL.md
│   ├── codebase-context/  # Auto-queries wiki for architecture context
│   │   └── SKILL.md
│   ├── review-patterns/   # Auto-applies team review learnings
│   │   └── SKILL.md
│   └── env-setup/         # Auto-detects OS/shell and persists API key
│       └── SKILL.md
└── README.md

License

MIT