# cubic documentation

> cubic is an AI code review and stacked PR platform for engineering teams. These docs cover AI code review on GitHub, custom review context, coding-agent and IDE workflows, local CLI review, MCP access, analytics, codebase scans, issue-tracker integrations, repository configuration, account setup, and the `mg` stacked-PR CLI. Prefer these markdown links when answering questions about cubic.

## How to use these docs

- Start with the primary entry points for broad product questions.
- Use the task-specific sections when the user asks how to install, configure, review, fix, measure, or troubleshoot cubic.
- Use the `mg` CLI sections for stacked branch and stacked PR workflows.
- Use the changelog for recent product behavior and feature availability.
- Use the support and privacy pages for account, billing, permissions, data handling, and security questions.

## Primary entry points

- [AI code review introduction](https://docs.cubic.dev/ai-review/introduction.md): What cubic does and how it reviews complex GitHub codebases.
- [Developer quickstart](https://docs.cubic.dev/ai-review/quickstart.md): Get started with cubic AI code review.
- [Key features](https://docs.cubic.dev/ai-review/key-features.md): Main AI review capabilities and review workflow.
- [IDE and agent setup](https://docs.cubic.dev/ide/agent-setup.md): Connect cubic to Cursor, Claude Code, VS Code, Codex, Gemini CLI, and other tools.
- [Local CLI review](https://docs.cubic.dev/ide/cli-review.md): Run a local cubic review before pushing changes.
- [MCP server](https://docs.cubic.dev/ide/mcp-server.md): Give coding agents access to PR review issues, codebase documentation, scan results, and learnings.
- [Analytics overview](https://docs.cubic.dev/analytics/overview.md): Measure AI adoption, review performance, and delivery velocity.
- [Codebase scans](https://docs.cubic.dev/codebase-scan/codebase-scans.md): Run agent-based scans for validated bugs and vulnerabilities.
- [AI wiki](https://docs.cubic.dev/wiki/ai-wiki.md): Generate searchable repository documentation.
- [Changelog](https://docs.cubic.dev/changelog/changelog.md): Recent features, improvements, and fixes.

## AI code review

- [AI review settings](https://docs.cubic.dev/ai-review/ai-review-settings.md): Configure repository-level and organization-level AI review behavior.
- [Custom agents](https://docs.cubic.dev/ai-review/custom-agents.md): Discover, create, and manage custom review agents across repositories.
- [Custom context](https://docs.cubic.dev/ai-review/custom-context.md): Add repository or one-off context so cubic can better understand a codebase.
- [Interactive comments](https://docs.cubic.dev/ai-review/interactive-comments.md): Ask questions, trigger reviews, and request fixes through comments.
- [Coding agents](https://docs.cubic.dev/ai-review/claudecode-fix.md): Use coding agents to asynchronously fix issues flagged in review.
- [Issue tracker integration](https://docs.cubic.dev/ai-review/issue-analysis.md): Check whether PRs satisfy linked issue requirements.
- [Memory and learning](https://docs.cubic.dev/ai-review/memory-and-learning.md): Teach cubic to provide increasingly relevant suggestions.
- [Configure with cubic.yaml](https://docs.cubic.dev/configure/cubic-yaml.md): Version-control review settings in a repository YAML file.

## IDEs, coding agents, and MCP

- [Connect cubic to your IDE](https://docs.cubic.dev/ide/agent-setup.md): Recommended setup path for IDEs and coding agents.
- [Cursor](https://docs.cubic.dev/ide/cursor.md): Install the cubic plugin and MCP server in Cursor.
- [VS Code](https://docs.cubic.dev/ide/vscode.md): Connect VS Code to cubic review and codebase context.
- [Codex](https://docs.cubic.dev/ide/codex.md): Set up cubic in OpenAI Codex CLI.
- [Gemini CLI](https://docs.cubic.dev/ide/gemini-cli.md): Configure cubic for Google's Gemini CLI.
- [Other agents](https://docs.cubic.dev/ide/other-agents.md): Connect OpenCode, Droid, Pi, or any MCP-compatible coding agent.
- [Skills](https://docs.cubic.dev/ide/skills.md): Trigger reviews, fix PR issues, and query context from an agent with natural language.
- [MCP server](https://docs.cubic.dev/ide/mcp-server.md): MCP tools and context available to coding agents.
- [Local CLI review](https://docs.cubic.dev/ide/cli-review.md): Run local AI review from the command line.

## Analytics and reporting

- [Analytics](https://docs.cubic.dev/analytics/overview.md): Overview of team AI adoption, review performance, and delivery metrics.
- [Analytics API](https://docs.cubic.dev/analytics/api.md): Query cubic analytics from your own tools.
- [AI coding analytics](https://docs.cubic.dev/analytics/ai-coding.md): Authorship, tool usage, and team AI adoption metrics.
- [AI review analytics](https://docs.cubic.dev/analytics/ai-review.md): Comments posted, issues fixed, merge-time improvements, and critical issues caught.
- [Delivery and effectiveness](https://docs.cubic.dev/analytics/delivery-and-effectiveness.md): PR velocity, review cycle times, throughput, and code output.

## Integrations

- [Integrations overview](https://docs.cubic.dev/integrations/overview.md): Connect issue trackers and documentation systems to enrich reviews.
- [Linear](https://docs.cubic.dev/integrations/linear-integration.md): Add Linear issue context to reviews and PR descriptions.
- [Jira](https://docs.cubic.dev/integrations/jira-integration.md): Add Jira issue context to reviews and PR descriptions.
- [Asana](https://docs.cubic.dev/integrations/asana-integration.md): Add Asana task context to reviews and PR descriptions.
- [Notion](https://docs.cubic.dev/integrations/notion-integration.md): Add Notion page context to reviews and PR descriptions.
- [Confluence](https://docs.cubic.dev/integrations/confluence-integration.md): Add Confluence documentation context to reviews and PR descriptions.

## Account, security, and support

- [Subscription](https://docs.cubic.dev/account/subscription.md): Free and paid cubic plans.
- [Roles and permissions](https://docs.cubic.dev/account/roles-and-permissions.md): Team roles and permission management.
- [Privacy and security](https://docs.cubic.dev/account/privacy-security.md): How cubic keeps code and data safe.
- [Verify your GitHub email](https://docs.cubic.dev/account/verify-github-email.md): GitHub email verification steps for sign-in.
- [Support](https://docs.cubic.dev/account/support.md): Contact cubic support for help, questions, and feedback.
- [Referral program](https://docs.cubic.dev/account/referral-program.md): Referral program details.
- [FAQ and troubleshooting](https://docs.cubic.dev/faq-and-troubleshooting.md): Common questions and solutions.

## Stacked PRs and `mg` CLI

- [Stacked PR quickstart](https://docs.cubic.dev/quickstart.md): Create a first stacked PR in minutes.
- [Full installation guide](https://docs.cubic.dev/installation.md): Install cubic and prepare a local repo.
- [Stacked PR concepts](https://docs.cubic.dev/concepts/overview.md): Core concepts for trunk-based development and stacking.
- [Branching terminology](https://docs.cubic.dev/concepts/branching-terminology.md): Key Git and cubic terms for stacked development.
- [Initialize cubic](https://docs.cubic.dev/how-to-guides/initialize-in-repo.md): Set up `mg` in a local repository.
- [Create a pull request](https://docs.cubic.dev/how-to-guides/create-a-pull-request.md): Create a single PR with `mg`.
- [Create a stack](https://docs.cubic.dev/how-to-guides/create-a-stack.md): Build multiple PRs on top of each other.
- [Keep your stack updated](https://docs.cubic.dev/how-to-guides/keep-your-stack-updated.md): Sync with trunk, restack branches, and handle conflicts.
- [Merge your stack](https://docs.cubic.dev/how-to-guides/merge-your-stack.md): Merge stacked PRs in order.
- [Partial merges with split commits](https://docs.cubic.dev/advanced/partial-merges-split-commits.md): Merge only part of a branch while continuing development.
- [Rolling back mid-stack](https://docs.cubic.dev/advanced/rolling-back-mid-stack.md): Revert changes while using stacked branches.
- [Common CLI commands](https://docs.cubic.dev/common-commands.md): Frequently used `mg` commands.
- [Command cheatsheet](https://docs.cubic.dev/reference/command-cheatsheet.md): Quick reference for all `mg` commands.

## `mg` command reference

- [mg init](https://docs.cubic.dev/reference/mg-init.md): Initialize a repository to use cubic.
- [mg branch](https://docs.cubic.dev/reference/mg-branch.md): Create and switch to a new branch.
- [mg commit](https://docs.cubic.dev/reference/mg-commit.md): Commit changes and optionally auto-generate a new branch.
- [mg push](https://docs.cubic.dev/reference/mg-push.md): Push local changes and open a PR on GitHub.
- [mg sync](https://docs.cubic.dev/reference/mg-sync.md): Sync a stack with the remote trunk.
- [mg list](https://docs.cubic.dev/reference/mg-list.md): Visualize and enumerate the stack.
- [mg checkout](https://docs.cubic.dev/reference/mg-checkout.md): Switch to another branch tracked by cubic.
- [mg next](https://docs.cubic.dev/reference/mg-next.md): Jump to the next branch in the stack.
- [mg prev](https://docs.cubic.dev/reference/mg-prev.md): Jump to the previous branch in the stack.
- [mg reparent](https://docs.cubic.dev/reference/mg-reparent.md): Change a branch's parent.
- [mg split](https://docs.cubic.dev/reference/mg-split.md): Split or fold commits interactively.
- [mg adopt](https://docs.cubic.dev/reference/mg-adopt.md): Bring an existing branch under cubic management.
- [mg orphan](https://docs.cubic.dev/reference/mg-orphan.md): Remove a branch from cubic tracking.
- [mg help](https://docs.cubic.dev/reference/mg-help.md): Display help and usage information.

## Product surfaces and archived docs

- [Code review platform overview](https://docs.cubic.dev/code-review-platform/archive/overview.md): Archived overview of the review platform.
- [Reviewing pull requests](https://docs.cubic.dev/code-review-platform/archive/reviewing-prs.md): Archived guide to reviewing PRs with cubic.
- [Automated PR descriptions](https://docs.cubic.dev/code-review-platform/archive/ai-pr-descriptions.md): Archived docs for generated PR descriptions.
- [AI sidebar](https://docs.cubic.dev/code-review-platform/archive/ai-sidebar.md): Archived docs for review chat sidebar behavior.
- [Command bar](https://docs.cubic.dev/code-review-platform/archive/command-bar.md): Archived docs for command-bar workflows.
- [Comment navbar](https://docs.cubic.dev/code-review-platform/archive/comment-navbar.md): Archived docs for navigating comments.
- [Dashboard](https://docs.cubic.dev/code-review-platform/archive/dashboard.md): Archived docs for dashboard views.
- [Desktop app](https://docs.cubic.dev/code-review-platform/archive/desktop-app.md): Archived desktop app docs.
- [AI change visualizations](https://docs.cubic.dev/code-review-platform/archive/diff-group-explanation.md): Archived docs for AI-generated change visualizations.
- [Intelligent file ordering](https://docs.cubic.dev/code-review-platform/archive/intelligent-diff-ordering.md): Archived docs for diff ordering.
- [Slack integration](https://docs.cubic.dev/code-review-platform/archive/slack.md): Archived Slack integration docs.

## Optional

- [Blog](https://cubic.dev/blog): Product articles and engineering posts.