cubic

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/skills
/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

# Universal (.agents/skills)
npx @cubic-plugin/cubic-plugin install --to universal

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/skills

# 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/skills"
      }
    }
  },
  "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.

Non-interactive JSON mode (for wrappers/installers)

When using JSON mode (--json) from another CLI wrapper, installation is intentionally non-interactive. Set CUBIC_API_KEY first:

CUBIC_API_KEY="cbk_..." npx -y @cubic-plugin/cubic-plugin install --json --method symlink

If CUBIC_API_KEY is missing, JSON mode returns a structured install_failed event with code: "AUTH_REQUIRED".

Tip: In Claude Code, you can also just say "set up my cubic key" and paste your key — the installer 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: