Skip to main content
The cubic plugin connects your AI coding agent to cubic.

​
Quick start

1

Run the installer

npx @cubic-plugin/cubic-plugin install
2

Grab your API key

The installer opens the cubic dashboard in your browser. Generate a key and paste it back in the terminal to finish setup.
3

Try it

Open your agent and try:
review my code

how does auth work?

check cubic issues
The plugin includes skills that activate based on what you ask.

​
Agent-specific installation

The npx installer auto-detects your agent. To target a specific one, pass --to: 
npx @cubic-plugin/cubic-plugin install
To uninstall, pass uninstall with the same --to flag you used to install.
API keys are personal to each user. Each team member generates their own key, which grants access only to repositories they’re authorized to view. Don’t share keys between team members.

​
Commands

CommandDescription
/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
The /cubic-run-review command requires the cubic CLI. Install it via curl -fsSL https://cubic.dev/install | bash.

​
Skills

The plugin includes five skills that activate automatically based on what you’re doing:
SkillActivates whenWhat it does
review-and-fix-issuesWorking on a PR branch or fixing review commentsFetches all cubic issues, investigates each, and reports which are worth fixing
run-review”Review my code”, pre-commit/PR quality checksRuns a local cubic AI code review via CLI and surfaces issues
codebase-contextAsking about architecture or how things workQueries the cubic AI Wiki for architectural context
review-patternsWriting or reviewing codePulls team learnings to apply coding conventions
env-setupSetting up cubic or pasting an API keyDetects OS and shell, persists API key to shell config

​
MCP tools

The plugin connects to cubic’s MCP server, which provides nine tools for accessing cubic data:
  • 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
For complete documentation on MCP tools, parameters, and workflows, see the MCP server docs.

​
Troubleshooting

  • Verify your CUBIC_API_KEY environment variable is set
  • The key must start with cbk_
  • Check the key hasn’t been revoked in cubic settings
  • Restart your editor after setting the environment variable
This command requires the cubic CLI. Install it via:
curl -fsSL https://cubic.dev/install | bash
Verify with cubic --version.
  • Verify you’re running Claude Code v1.0.33 or later
  • Check the marketplace was added: /plugin marketplace list
  • Try reinstalling: /plugin uninstall cubic@cubic then /plugin install cubic@cubic