jira-me
TLDR
Display the configured jira user
List issues assigned to me
List issues from the current sprint, assigned to me
Display help
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)


