Skip to main content
Assign Linear issues to Tembo and turn them into PRs.

​
Features

  • Assign issues to Tembo to trigger work
  • AI-powered code solutions with pull request generation
  • Interactive repository selection when starting tasks

​
Installation

1

Install

Navigate to the Integrations page in Tembo and click the Install button next to Linear.
2

Authorize

Authorize Tembo to access your Linear workspace. You’ll be redirected back to the Integrations page when complete.
3

Repository Labels

Tembo automatically creates a “Tembo Git Repositories” label group with all your GitHub repositories. Use these labels to specify which repository Tembo should target for each issue.You can set a default repository to avoid adding labels to every issue.
4

Start Using Tembo

Now you can assign Linear issues to Tembo to trigger solutions.

​
Supported Triggers

Tembo maps Linear activity to automation triggers (use a linear.* naming convention in your triggerName). The Integrations page in the app shows the live set enabled for your org. Supported events:
  • issue.created
  • issue.updated
  • issue.labeled
  • issue.assigned
  • comment.created
See Automations for how to create triggers from these events.

​
Usage

​
Triggering Tembo

Assign the issue directly to Tembo. The bot user should appear in your Linear workspace after completing the integration setup.

​
Repository Selection

When you assign a Linear issue to Tembo, you’ll be prompted to select which repository to work on:
  1. Assign the issue - Assign the Linear issue to Tembo
  2. Select repository - Tembo will present you with a dropdown menu of available repositories
  3. Choose your repository - Select one repository from the list, or type to select multiple repositories
  4. Tembo starts work - Once you’ve made your selection, Tembo will automatically begin working on the task

​
Working with Multiple Repositories

For tasks that span multiple repositories (e.g., full-stack features):
  1. When prompted for repository selection, type the names of multiple repositories
  2. Example: Type “frontend backend” or select both repositories
  3. Tembo will create separate pull requests for each repository and coordinate changes across all selected repositories

​
Status Updates

Tembo keeps you informed as it works on your Linear issues:
  • Interactive Prompts - Tembo will ask you to select a repository and confirm before starting work
  • Progress Updates - Tembo provides real-time updates as it works through the task
  • Status Changes - Tembo automatically updates the Linear issue status as it progresses through the task
  • Comments - Tembo adds comments to the issue with progress updates and links to pull requests
  • Pull Request Links - When code changes are ready, Tembo comments with a link to the generated PR

​
Best Practices

  • Write clear, actionable descriptions — “Add email validation to registration form” not “Fix the bug”
  • Include relevant context — Add screenshots, error logs, acceptance criteria, or related issues
  • Choose all needed repositories — For full-stack features, select both frontend and backend repos

​
Troubleshooting

Tembo not responding? Verify the issue is assigned to the Tembo bot user, check the Integrations page for integration status and webhook settings (issue.assigned should be enabled). Repository selection not appearing? Ensure you’ve connected a code hosting provider (GitHub/GitLab) and that repositories are visible in your dashboard. Try unassigning and reassigning the issue. PRs not being created? Check that Tembo has write access to the repository, provide clearer requirements in the issue description, and verify branch protection rules allow new branches.

​
MCP Server Integration

When you connect Linear to Tembo, an MCP server is automatically available to agents. Agents can query and filter issues, access project details and milestones, check issue relationships, and read comments and activity in real-time while implementing features or fixes.