Jira items drawer

Browse, edit, and link Jira Cloud or self-hosted Server/Data Center issues to worktrees the same way you link Linear or GitHub items.

Jira sits next to GitHub and Linear in the task drawer. Browse Jira issues, update them, and create a worktree from any issue without leaving Nethür.

Connect a Jira site

  1. Open the Tasks sidebar entry and pick Jira from the source picker — Jira sits next to GitHub and Linear by default, even before any credentials are saved.
  2. Click Connect Jira. The Connect Jira site dialog appears.
  3. Choose Cloud or Self-hosted (Server / Data Center).

Cloud

  • Jira Cloud site URL — e.g. https://example.atlassian.net.
  • Atlassian email — the address on your Atlassian account. Optional for scoped tokens: leave it empty to use Bearer authentication.
  • Atlassian API token — create one at id.atlassian.com → Security → API tokens, with or without scopes.

Scoped tokens need read:jira-work to browse issues, write:jira-work to create or edit issues and comments, and read:jira-user to verify the account and choose assignees. Board column ordering additionally needs read:board-scope:jira-software, read:board-scope.admin:jira-software, and read:project:jira; without these, statuses sort alphabetically.

Nethür looks up the site's cloud ID without sending the token, then routes scoped-token API requests through https://api.atlassian.com/ex/jira/<cloudId>. With an email, it tries the site first and retries on the gateway only after a 401. Browse links keep using the site URL. A missing scope reports the endpoint and required access without removing the saved credential.

For SSH connections, the remote runtime owns the token and API requests. Older remote runtimes still require an email and an unscoped token; update the remote runtime to enable scoped tokens.

Self-hosted

  • Jira base URL — your Server/DC base (including path if Jira is not at /).
  • Auth method:
    • Personal access token — Bearer PAT (preferred on modern Server/DC).
    • Username and password — Basic auth for older instances without PATs.
  1. Click Connect. Nethür verifies the credentials and loads your sites.

You can connect more than one Atlassian site. The Tasks header has a site picker once a site is connected; choose All sites to combine issues across them.

If you don't use Jira at all, hide it from the source picker via Settings → Tasks.

Using Jira

  • The task drawer shows GitHub, Linear, and Jira issues in a unified list once each source is enabled.
  • Open an issue to see the full description, comments, and metadata in a side drawer. Edit status (via available transitions), priority, assignee, and custom fields inline.
  • Add a comment from the drawer's comment composer.
  • New Jira issue keeps title and description if you dismiss the dialog by accident — Escape, Cancel, outside click, or close. Text restores when you reopen the dialog in the same app session; drafts clear after a successful create and do not survive an app restart. Issue type and other pickers still use their usual open-time defaults.
  • Creating a worktree from a Jira issue pre-fills the task name and links the worktree to the issue, so the review and the issue stay tied together.
  • From the Create workspace dialog you can also paste a Jira issue URL (https://…/browse/ABC-123) into the name field, or switch the field to Jira search and pick an issue by text. Nethür fills the workspace name, links the issue, and shows the key + summary on the worktree card with View on Jira. Paste is multi-site aware: when more than one connected site matches the URL origin, Nethür asks which site to use; when none match, it says the site is not connected.
  • Nethür remembers your last-used task source per repo, so a Jira-driven repo defaults to Jira on next open.

Next steps