Geera lets you quickly change branches based on Jira tickets without thinking about their names. It can find a existing branch or create new if needed.
- Linux or MacOS
- GIT client installed
TODO: Write installation instructions here
- Go to Jira API token and create new API token
- Run
geera configureand finish configuration
$ geera configure
[Geera v0.1.0]
Connect your Jira account by passing your company domain and credentials:
Domain (from url: https://XXXXX.atlassian.net) where XXXXX is your company domain: geera
Atlassian email: email@example.com
Atlassian API token: (paste your token here)
Select your teams\' board:
1. GEE - Geera project
33. VIP - Very Interesting Project
66. GAA - Great And Awesome
# Select your project by passing a number and confirm
1
New configuration has been saved at /Users/username/.geera/config.env- Switch to a branch or create new
# Branch already exists in Git (locally or remote)
$ geera 1234
Switched to branch 'task/GEE-1234-implement-cli'
# Branch exists in Jira but not in Git so we create it
$ geera 888
Switched to a new branch 'sub-task/GEE-888-add-top-readme-description'
# Branch doesn't exist locally and in Jira
$ geera 871283712831839
Given issue [GEE-871283712831839] doesn\'t exist$ geera configure- lets you configure geera. Config is store in~/.geera/config.env$ geera XXX- replacing XXX with a Jira issue number lets you find Jira/Git task and checkout on it
- Fork it (https://github.com/KamilZielinski/geera/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
- Kamil Zieliński - creator and maintainer