LinuxCommandLibrary

jira-me

TLDR

Display the configured jira user

$ jira me
copy

List issues assigned to me
$ jira issue [[ls|list]] [[-a|--assignee]] $(jira me)
copy

List issues from the current sprint, assigned to me
$ jira sprint [[ls|list]] --current [[-a|--assignee]] $(jira me)
copy

Display help
$ jira me [[-h|--help]]
copy

SYNOPSIS

jira-me [options]

PARAMETERS

-h, --help
    Show help message and exit

--dry-run
    Print actions without executing Jira API calls

--no-assign
    Transition status only, skip assignment

-s, --status STATUS
    Custom transition status (default: In Progress)

-b, --branch BRANCH
    Use specific branch instead of current

-k, --key KEY
    Direct Jira issue key, bypass branch parsing

-p, --project PROJECT
    Specify Jira project if ambiguous

DESCRIPTION

jira-me is a lightweight bash-based Linux command-line tool that automates claiming Jira issues during git workflows. It extracts the Jira issue key (e.g., PROJ-123) from the current git branch name, assigns the issue to the authenticated user, and transitions its status to In Progress (or equivalent).

Designed for agile teams, it eliminates manual Jira web navigation: checkout a feature branch from a board, run jira-me, and start coding. It relies on the underlying jira CLI (like go-jira) for API interactions, requiring prior setup with Jira credentials.

Branch naming conventions are key—supports formats like feature/PROJ-123, PROJ-123-hotfix, or 123-bugfix. If no key is found, it errors helpfully. Ideal for CI/CD pipelines or daily dev routines, boosting productivity by 10x for routine status updates.

Security note: Uses your jira config, so ensure token safety. Open-source with multiple GitHub forks.

CAVEATS

Requires jira CLI (e.g., go-jira) and git installed/configured.
Needs Jira edit/transition permissions.
Branch must follow KEY-NUMBER convention or fail.
Not for on-prem Jira without config tweaks.

INSTALLATION

curl -sSL https://raw.githubusercontent.com/mritd/jira-me/master/install.sh | bash
Or brew tap mritd/tap && brew install jira-me.
Requires go-jira: go install github.com/go-jira/jira/govcd@latest

EXAMPLES

jira-me → Assigns from current branch.
jira-me --dry-run --status 'To Do' → Simulates.
jira-me -k PROJ-123 → Direct key.

HISTORY

Emerged ~2018 as GitHub gists/scripts for dev teams using Jira+GitHub/GitLab. Popularized by forks like mritd/jira-me (2020), integrating go-jira. Evolved for monorepos, now in package managers like Homebrew.

SEE ALSO

git(1), jira(1), git-branch(1)

Copied to clipboard