
How it works
When cubic identifies an issue in your code, you can request an AI-generated fix that:- Analyzes the issue - Reviews the problem and relevant context
- Generates a solution - Creates a targeted fix addressing the specific issue
- Applies the fix - Pushes commits to your PR branch by default, or opens a fix PR when requested
- Preserves review flow - Lets you review the changes before merging into your main PR
By default, cubic pushes commits directly to your PR branch. To override, include “open a fix PR”
in your request. If cubic opens a fix PR, it targets the branch of your original PR, not the main
branch.
Triggering fixes
There are two ways to request an AI fix:Tagging cubic in Github or cubic

- “@cubic fix this issue”
- “@cubic-dev-ai can you generate a fix for this?”
- “@cubic please fix the type error mentioned above”
cubic only treats the current comment as permission to edit code when that comment explicitly
tags cubic.
@cubic, @cubic-dev-ai, and other supported cubic tags work. Replying inside a
cubic-started thread without a fresh tag is treated as discussion, feedback, or questions, not
authorization to push changes.Using the fix button in cubic
For inline review comments, click the Generate fix button in the comment actions menu. Dashboard-triggered fixes commit directly to the PR’s branch by default. This is available when:- The comment identifies a specific issue in a file
- The comment includes file and line context
- Your installation has the fix feature enabled
What to expect
Fix generation process
- Acknowledgment - cubic reacts with 👀 and comments
- Analysis - The AI analyzes the issue and surrounding code
- Delivery - cubic pushes commits to your PR branch by default, or opens a fix PR if requested. Claude Code runs in an ephemeral container in the background. (typically 1-3 minutes)
- Notification - cubic updates the original comment with the commit or PR details
Reviewing changes
If cubic opens a fix PR, it includes:- Descriptive title - AI-generated title explaining what’s being fixed
- Targeted changes - Only the code needed to address the specific issue
- Original context - Reference to the original PR and issue comment
- Clean diff - Easy to review changes in isolation
If a fix PR is created, you can test the changes locally by checking out the fix branch before
merging.
Best practices
Tips for using AI fixes
- Review carefully - Always review AI-generated code before merging
- Test locally - Verify the fix works as expected in your environment
Limitations
- Complex architectural changes may require manual intervention
- Fixes are scoped to the specific issue identified
- Some issues may require broader refactoring beyond a single fix
- Follow-up changes are not yet supported
- Generated PRs or pushed commits run through your existing GitHub CI checks
Coding agent providers
You can choose which coding agent applies fixes. cubic supports two providers:- Default (cubic with Claude) - cubic generates and applies fixes using Claude models. This works out of the box and needs no configuration.
- Cursor cloud agents - cubic hands off fixes to Cursor cloud agents running in your own Cursor account. This requires a one-time connection.
Connect Cursor cloud agents
Before you can select Cursor cloud agents, connect them in Settings → Integrations → Coding agent providers.Create a Cursor key
In Cursor, create an API key or a service account key. See Cursor’s
API documentation for how to create keys.
Add the key in cubic
Open Settings → Integrations → Coding agent providers and select Cursor cloud agents.
Choose the key type (API key or Service account key), paste the key (it starts with
crsr_), and save. cubic validates the key with Cursor and stores it encrypted.Disconnecting Cursor cloud agents removes the stored key and switches any repositories using it
back to the default provider (cubic with Claude models). You can reconnect at any time.
Integration with your workflow
Fixes integrate seamlessly with your existing review process:- Review the change (fix PR or new commits on your PR branch)
- Merge when satisfied if a fix PR was opened
- Continue with your original PR now including the fix
- Single deployment - Everything ships together