Jira

Connect a Jira site with an API token and work issues from the sidebar.

Last updated Jun 06, 2026

The Jira integration surfaces issues from your Jira site inside GridTree, so you can create a worktree from an issue, assign it, and move it through its workflow without leaving the app.

Connect#

Open Settings → Jira and add a connection. GridTree authenticates with an Atlassian API token — not a browser OAuth flow. You provide four things:

Connection name — a label, so you can connect more than one site.
Site URL — e.g. https://your-domain.atlassian.net.
Email — the account the token belongs to.
API token — create one from Atlassian's API tokens page; GridTree links you there.

The token is stored encrypted on your machine.

Pick a project#

Each GridTree project is linked to one Jira connection and one Jira project, identified by its project key — PROJ, WEB, and so on. Issue keys like PROJ-456 belong to project PROJ. You set this per project in settings, alongside the branch-name pattern used when you create a worktree from an issue.

What you get#

Issues in the sidebar, grouped by saved JQL sections you define per project.
Browse and read — open the issues from your filters and read their full descriptions without leaving GridTree.
Start work from an issue — create a worktree for it (the branch is named from the issue key and summary) and hand it straight to an agent with a quick action. The agent pulls the issue's details over the MCP server, so it starts with the full context.
Assign and transition issues — pick up an issue and move it through its workflow from GridTree.