m-bal / gira

Gira

Install Binary

Requires Cargo to be install. Installation guide

cargo install --git https://github.com/m-bal/gira.git

Cargo installs the binary into ${HOME}/.cargo/bin

Add the path to your .bashrc if it doesn't exist:

export PATH="$PATH:<path-to-.cargo/bin>"

Configure Gira

Gira needs to know the name of the jira site you are using:

git config --global jira.host https://<company_name>.atlassian.net

In order for Gira to connect to Jira, you need to create an API token using this guide.

git config --global jira.token <api_token>

verify

jira.host and jira.token should appear in this list with the values you provided.

git config --global --list

If you don't see the token and host in the list, run git config --global --edit and add them to the file:

[jira]
    token=<api_token>
    host=<host>

Jira Email

If your jira account email is different from your git configured user.email, then you can set jira.email

git config --global jira.email <jira-account-email>

Usage

Usage: gira [COMMAND]

Commands:
  start     Creates a branch based on the jira issue id (PROJECT-ID)
  list      List issues assigned to you (uses jira.email or user.email to filter)
  list-all  List all issues
  bump      bump the branch version (creating a new branch for the current issue)
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Usage: gira start <ISSUE_ID>

Arguments:
  <ISSUE_ID

Options:
  -h, --help  Print help

Usage: gira list [OPTIONS]

Options:
  -p, --project <PROJECT>  Filter by project name
  -f, --filter <FILTER>    Search an issue's Summary, Description, Environment and Comme
nts field
  -h, --help               Print help

Usage: gira list-all [OPTIONS]

Options:
  -p, --project <PROJECT>  Search by project name
  -f, --filter <FILTER>    Search an issue's Summary, Description, Environment and Comme
nts field
  -h, --help               Print help

gira's Issues

Update issue team

Thanks for making gira!

How about auto-assigning the team of an issue based on the user’s configuration when starting it?

But only if the issue has no current team.

> cat ~/.config/gira/config.yml
team: awesome

Readme typo

I think

git config --global list

Should be

git config --global --list

Update issue assignee

Thanks for making gira!

Can you add a feature that automatically updates the assignee of an issue when starting a new branch for it?

But only if the issue is currently unassigned.