# cubic documentation

> cubic reviews code on GitHub, in its pull request UI, and in local coding workflows. These docs cover review setup, reviewing PRs in cubic, coding agents, repository context, analytics, and account management. Older stacking guides are listed separately below.

## 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 older `mg` CLI sections only for questions about that stacking tool, not the current local-review CLI.
- Use the Review in cubic section for the current PR UI, inbox, grouped changes, and AI chat.
- 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.
- [Review in cubic](https://docs.cubic.dev/code-review-platform/overview.md): Understand, discuss, and merge GitHub pull requests in cubic.
- [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, or headless in CI and cloud agents with an API key.
- [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.md): Recent features, improvements, and fixes.

## AI code review

- [Ultrareview](https://docs.cubic.dev/ai-review/ultrareview.md): Request a deeper review for complex or high-risk changes.

- [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.
- [Cross-repo reviews](https://docs.cubic.dev/ai-review/cross-repo-reviews.md): Allow cubic to read selected repositories during PR review.
- [Interactive comments](https://docs.cubic.dev/ai-review/interactive-comments.md): Ask questions, trigger reviews, and request fixes through comments.
- [Auto-approval](https://docs.cubic.dev/ai-review/auto-approval.md): Let cubic approve clean pull requests when repository policy allows it.
- [Coding agents](https://docs.cubic.dev/ai-review/coding-agents.md): Use coding agents to asynchronously fix issues flagged in review.
- [Auto-fix](https://docs.cubic.dev/ai-review/auto-fix.md): Let cubic fix the issues it finds in your pull requests.
- [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.

## Review in cubic

- [Review in cubic](https://docs.cubic.dev/code-review-platform/overview.md): Open a GitHub PR in cubic and understand the review workflow.
- [Review a pull request](https://docs.cubic.dev/code-review-platform/reviewing-prs.md): Read diffs, compare versions, leave comments, submit reviews, and merge.
- [Grouped changes](https://docs.cubic.dev/code-review-platform/intelligent-diff-ordering.md): Follow related changes in review order with explanations and progress tracking.
- [AI chat](https://docs.cubic.dev/code-review-platform/ai-sidebar.md): Ask about code, take a guided tour of a PR, and draw diagrams.
- [Pull request inbox](https://docs.cubic.dev/code-review-platform/dashboard.md): Find reviews waiting on you and follow your own PRs.
- [Keyboard shortcuts](https://docs.cubic.dev/code-review-platform/command-bar.md): Search PRs and actions, navigate files, and review from the keyboard.
- [Desktop app](https://docs.cubic.dev/code-review-platform/desktop-app.md): Keep your review queue in the menu bar and get notified when cubic finds issues on your PRs.

## 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.
- [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, or headless in CI with an API key.

## 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.

## API reference

- [API overview](https://docs.cubic.dev/api-reference/overview.md): Choose the Members or Analytics API, the keys they accept, and their plan requirements.
- [Members API guide](https://docs.cubic.dev/account/members-api.md): Generate a personal API key and manage member seats and roles.
- [List organizations](https://docs.cubic.dev/api-reference/members/list-organizations.md): List organizations accessible to your account.
- [List members](https://docs.cubic.dev/api-reference/members/list-members.md): Filter and paginate an organization's members.
- [Get a member](https://docs.cubic.dev/api-reference/members/get-member.md): Read a member's current seat and role.
- [Update a member](https://docs.cubic.dev/api-reference/members/update-member.md): Change a seat or role using expected values and purchased seat capacity.
- [List pull request analytics](https://docs.cubic.dev/api-reference/analytics/list-pull-requests.md): Export merged pull requests, issue counts, and AI authorship data with a personal or organization API key on Pro or Max.

## 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

- [AI review usage and limits](https://docs.cubic.dev/account/ai-review-usage.md): Reviewed-line metering, allowances, and resets.

- [Subscription](https://docs.cubic.dev/account/subscription.md): Free and paid cubic plans.
- [Flex capacity](https://docs.cubic.dev/account/flex-capacity.md): Extra reviewed-line capacity pricing, spend limits, payment behavior, and examples.
- [Roles and permissions](https://docs.cubic.dev/account/roles-and-permissions.md): Team roles and permission management.
- [Members API](https://docs.cubic.dev/account/members-api.md): List organization members and manage their seats and roles from your own tools.
- [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.

## Older stacking guides: `mg` CLI

These pages describe the `mg` stacking CLI. For current local code reviews, use [Local CLI review](https://docs.cubic.dev/ide/cli-review.md).

- [Stacking FAQ and troubleshooting](https://docs.cubic.dev/faq-and-troubleshooting.md): Git errors and `mg` troubleshooting.

- [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 a GitHub stack in one step, or other stacked PRs from the bottom up.
- [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.

## Optional

- [Blog](https://cubic.dev/blog): Product articles and engineering posts.
- [Bug Bench](https://www.cubic.dev/bugbench.md): Public leaderboard of AI coding models ranked by the bugs cubic finds in the code they write.
- [Code review standards](https://www.cubic.dev/standards): Code review rules for React, Next.js, Django, Rails, Go, PostgreSQL, and other stacks, with examples, ready to copy into AGENTS.md.
- [Code review agents](https://www.cubic.dev/agents): Every public code review agent by category, each shown with code it flags and code that passes.