# cubic documentation

> cubic reviews code on GitHub and in local coding workflows. These docs cover review setup, coding agents, repository context, analytics, and account management. Older stacking and archived platform 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.
- Archived platform guides describe historical interfaces, not current setup instructions.
- 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

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

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