Jira

Assign Jira tickets to Tembo and turn them into PRs.

Features

• Add the “Tembo” label to issues to trigger analysis
• Click provided links to view coding sessions and create PRs

Installation

1. Create Tembo Account

   Create a dedicated Jira account for Tembo using either an email alias ([e-mail]) or a dedicated email ([e-mail]). Invite this account to your Jira workspace and complete the sign-up process using the name “Tembo”.

2. Connect

   Navigate to the Integrations page in Tembo and click the Install button next to Jira. Make sure you’re logged into the Tembo Jira account (not your personal account) when completing this step.

3. Add Labels

   Create a “Tembo” label in your Jira project if it doesn’t exist:

   1. Navigate to your Jira project settings by clicking the gear icon in the project sidebar
   2. Select “Labels” from the project settings menu
   3. Click “Create label” and enter “Tembo” as the label name
   4. Save the label

   Once created, add this label to any issue you want Tembo to analyze and work on by editing the issue and selecting the “Tembo” label.

   
4. Start Sessions

   After labeling tickets, Tembo will comment with analysis and provide a link to view the session.

Supported Triggers

Tembo maps Jira activity to automation triggers (use a jira.* 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
• transition.changed
• comment.created

See Automations for how to create triggers from these events.

Usage

Triggering Tembo

Add the “Tembo” label to any Jira issue you want Tembo to work on. Once labeled, Tembo will:

1. Analyze the issue - Review the issue description, acceptance criteria, and any attached context
2. Create a coding session - Generate a solution based on the issue requirements
3. Comment with updates - Provide progress updates and a link to view the session
4. Create pull requests - Submit code changes as pull requests when ready

Status Updates

Tembo keeps you informed as it works on your Jira issues:

• Comments - Tembo adds comments to the issue with progress updates and links to coding sessions
• Pull Request Links - When code changes are ready, Tembo comments with links to generated pull requests
• Session Links - View detailed coding sessions to see how Tembo approached the problem

Troubleshooting

Tembo Not Responding to Labeled Issues

If Tembo doesn’t respond after adding the “Tembo” label:

1. Verify label name - Ensure the label is exactly “Tembo” (case-sensitive)
2. Check account setup - Confirm you completed the installation using the dedicated Tembo Jira account
3. Review permissions - Verify the Tembo account has permission to read and comment on issues in the project
4. Check integration status - Navigate to the Integrations page to ensure the Jira integration is active

Issues Not Being Processed

If labeled issues aren’t being processed:

1. Verify repository connection - Ensure you have connected GitHub, GitLab, or Bitbucket repositories to Tembo
2. Check issue format - Include clear descriptions and acceptance criteria to help Tembo understand the task
3. Review webhook status - The Integrations page shows the live set of enabled webhooks; ensure issue.labeled is enabled

Best Practices

• Write clear issue descriptions - Include detailed requirements, acceptance criteria, and context to help Tembo understand the task
• Use acceptance criteria - Define specific, measurable criteria so Tembo knows when the work is complete
• Attach relevant context - Include screenshots, error logs, or links to related issues when applicable
• Use Rule Files - Help Tembo understand your coding standards and project conventions
• Set up Hooks - Customize Tembo’s behavior to match your team’s workflow