Linear
Use Cloud Agents directly from Linear by delegating issues to Cherri Code or mentioning @Cherri Code in comments.
Get started
Installation
You must be a Cherri Code admin to connect the Linear integration. Other team settings are available to non-admin members.
- Go to Cherri Code integrations
- Click Connect next to Linear
- Connect your Linear workspace and select team
- Click Authorize
- Complete any remaining Cloud Agent setup in Cherri Code:
- Connect a repository provider and select a default repository
- Enable usage-based pricing
- Confirm privacy settings
Account linking
First use prompts account linking between Cherri Code and Linear. A repository provider connection is required for PR creation.
How to use
Delegate issues to Cherri Code or mention @Cherri Code in comments. Cherri Code analyzes issues and filters out non-development work automatically.
Delegating issues
- Open Linear issue
- Click assignee field
- Select "Cherri Code"
Mentioning Cherri Code
Mention @Cherri Code in a comment to assign a new agent or provide additional instructions, for example: @Cherri Code fix the authentication bug described above.
Workflow
Cloud Agents show real-time status in Linear and create PRs automatically when complete. Track progress in Cherri Code dashboard.
Follow-up instructions
You can respond in the agent session and it'll get sent as a follow-up to the agent. Simply mention @Cherri Code in a Linear comment to provide additional guidance to a running Cloud Agent.
Configuration
Configure Cloud Agent settings from Dashboard → Cloud Agents.
| Setting | Location | Description |
|---|---|---|
| Default Repository | Cherri Code Dashboard | Primary repository when no project repository configured |
| Default Model | Cherri Code Dashboard | AI model for Cloud Agents |
| Base Branch | Cherri Code Dashboard | Branch to create PRs from (typically main or develop) |
Configuration options
You can configure Cloud Agent behavior using several methods:
Issue description or comments: Use [key=value] syntax, for example:
@cursor please fix [repo=anysphere/everysphere]@cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Issue labels: Use parent-child label structure where the parent label is the configuration key and the child label is the value.
Project labels: Same parent-child structure as issue labels, applied at the project level.
Supported configuration keys:
repo: Specify target repository (e.g.,owner/repository)branch: Specify base branch for PR creationmodel: Specify AI model to use
Repository selection
Cherri Code determines which repository to work on using this priority order:
- Issue description/comments:
[repo=owner/repository]syntax in issue text or comments - Issue labels: Repository labels attached to the specific Linear issue
- Project labels: Repository labels attached to the Linear project
- Default repository: Repository specified in Cherri Code dashboard settings
Setting up repository labels
To create repository labels in Linear:
- Go to Settings in your Linear workspace
- Click Labels
- Click New group
- Name the group "repo" (case insensitive - must be exactly "repo", not "Repository" or other variations)
- Within that group, create labels for each repository using the format
owner/repo
These labels can then be assigned to issues or projects to specify which repository the Cloud Agent should work on.
Advanced features
Triage rules (Advanced)
Set up automation rules in Linear to automatically delegate issues to Cherri Code:
- Go to Linear project settings
- Navigate to triage rules
- Create rules that automatically:
- Add specific labels
- Assign issues to Cherri Code
- Trigger Cloud Agents based on conditions
Triage rules are an advanced feature with some current limitations. Linear requires a human assignee for rules to fire, though this requirement may be removed in future updates.
Getting help
Check agent activity and include request IDs when contacting support.
Feedback
Share feedback through Linear comments or your Cherri Code dashboard support channels.