JIRA ticket context manager for git workflows
Project description
jira-git-helper
A terminal-based JIRA ticket context manager for git workflows, invoked as jg.
Keeps the current JIRA ticket in your shell environment so that branch names, commit messages, and PR lookups are automatically prefixed — without you having to type the ticket key every time.
Installation
uv tool install jira-git-helper
Or with pipx:
pipx install jira-git-helper
Configuration
Run these once after installation:
jg config set server https://yourcompany.atlassian.net
jg config set email you@yourcompany.com
jg config set token <your-jira-api-token>
Optionally set a default JQL filter for the ticket picker (defaults to your assigned tickets):
jg config set jql "project = MYPROJECT AND assignee = currentUser() ORDER BY updated DESC"
Generate a JIRA API token at: https://id.atlassian.com/manage-profile/security/api-tokens
Shell hook
The hook lets jg set / jg clear update SJ_TICKET in your current shell,
so each terminal can track a different ticket independently.
Fish:
# Add to ~/.config/fish/config.fish
eval (jg hook)
Bash / Zsh:
# Add to ~/.bashrc or ~/.zshrc
eval "$(jg hook --shell bash)" # or --shell zsh
Tide prompt (fish)
jg setup
Then follow the printed instructions to add jg to your Tide prompt items.
Commands
| Command | Description |
|---|---|
jg |
Show the current ticket |
jg set [TICKET] |
Set ticket (interactive picker if no argument) |
jg clear |
Clear the current ticket |
jg info [TICKET] |
Show ticket details |
jg open [TICKET] |
Open ticket in browser |
jg branch [name] |
Switch to a ticket branch, or create one |
jg add |
Interactive staging UI with inline commit |
jg commit <message> |
Commit with ticket prefix |
jg push |
Push branch and open linked PR |
jg diff [TICKET] |
Diff an open/draft PR with gh |
jg prs [TICKET] |
List all linked PRs |
jg config get <key> |
Get a config value |
jg config set <key> <value> |
Set a config value |
jg config list |
List all config values |
jg hook [--shell fish|bash|zsh] |
Print shell hook |
jg setup |
Configure Tide prompt integration |
Requirements
- Python 3.10+
ghCLI (only required forjg diff) — https://cli.github.com
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jira_git_helper-0.2.0.tar.gz.
File metadata
- Download URL: jira_git_helper-0.2.0.tar.gz
- Upload date:
- Size: 21.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.3 {"installer":{"name":"uv","version":"0.10.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
58641deeccf1957e8ba2b87dd832e2138c3735af1253fd75dc780d42c1b2275d
|
|
| MD5 |
39ff22484ef76b688f3f84e10150459e
|
|
| BLAKE2b-256 |
4a7df93c5d79d3aaf651a6ed8be8057346dd601d3f0731b4cf8ff2f3eaa5d9df
|
File details
Details for the file jira_git_helper-0.2.0-py3-none-any.whl.
File metadata
- Download URL: jira_git_helper-0.2.0-py3-none-any.whl
- Upload date:
- Size: 13.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.3 {"installer":{"name":"uv","version":"0.10.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
60eac70acf16312e5196c457296d56e025041b94b94a22a21486c6e12e4068db
|
|
| MD5 |
db448aa05bcff253203c2b8adad8bfe7
|
|
| BLAKE2b-256 |
b1210ee6a9703525fe23c38dc814daca3edeaaac03bb28847ed94b33a04f8511
|
