Skip to content
Vör – Jira & Git made simple
Go Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd
env
formatters
git
jira
logger
rest
system
test-data
tests
utils
.editorconfig
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
Makefile
README.md
ROADMAP.md
example.vor
main.go

README.md

📋 changelog

                  ___          ___
      ___        /\  \        /\  \
     /\  \      /::\  \      /::\  \
     \:\  \    /:/\:\  \    /:/\:\__\
      \:\  \  /:/  \:\  \  /:/ /:/  /
  ___  \:\__\/:/__/ \:\__\/:/_/:/__/___
 /\  \ |:|  |\:\  \ /:/  /\:\/:::::/  /
 \:\  \|:|  | \:\  /:/  /  \::/~~/~~~~
  \:\__|:|__|  \:\/:/  /    \:\~~\
   \::::/__/    \::/  /      \:\__\
    ~~~~         \/__/        \/__/

Vör – Jira & Git made simple

In Norse mythology, Vör is the seeress. She is wise and of searching spirit, so that none can conceal anything from her. Her name means "awareness" or "to become aware of something", and she can be prayed to for intuitive information that cannot be acquired by normal means.

What is it?

Vor is a CLI tool that makes it really easy to connect jira and git/github it provides commands to create branches from a given jira ticket, github pull requests from that branch and makes it easy to view your assigned tickets - all without leaving the command line!

Commands

Create a branch for a specific jira issue

vor branch AQ-1234

creates a branch of the form {repo-name}/{issue-type}/{issue-number}/{issue-title} so for the aquicore repo issue 4753 would result in aquicore/story/AQ-4653/do-some-stuff-with-the-thing

Create a pr with my current branch

vor pull-request

list my issues in Jira

vor issues

View details of a specific issue

vor issue AQ-1234

Setup

Vör is project specific and usually requires a config at the root of that project (though this is not always true, it is recommended)

see an example config file here

The supported configuration options and their defaults are:

// output additional logging information at runtime
devmode: false

// the template to use for new branches
branchtemplate: {jira-issue-number}/{jira-issue-type}/{jira-issue-title}

// the path to your local git
git:
    path: /usr/local/bin/git

    // the base branch to make pull requests against
    pull-request-base: master

author: your name
email: you@yourdomain.xyz
jira:
    orgname: <your company name, usually contained in the url or your jira install>
    username: <your jira username (sometimes an email)>
    apikey: <your jira api key from id.atlassian.net>
github:
    owner: <the owner of the repository>
    apikey: <your github api key (get this from github.com/settings/tokens)>
    

you can also export the config options in your bash_profile or elsewhere like so:

export JIRA_API_KEY={your jira api key}

Copyright © 2018 Trevor Atlas Vör is a command line tool to make working to Jira and Git/Github easier

You can’t perform that action at this time.