Skip to content

Installation

CLI Installation

Install the gojira command-line tool:

go install github.com/grokify/gojira/cmd/gojira@latest

Verify the installation:

gojira version

SDK Installation

Add GoJira as a dependency to your Go project:

go get github.com/grokify/gojira

Import the packages you need:

import (
    "github.com/grokify/gojira"       // JQL builder, config
    "github.com/grokify/gojira/rest"  // REST API client
    "github.com/grokify/gojira/xml"   // XML parser
)

Requirements

  • Go 1.21 or later
  • Jira Cloud or Jira Server instance
  • API token (for Jira Cloud) or username/password (for Jira Server)

Getting an API Token

For Jira Cloud, you need an API token instead of your password:

  1. Go to Atlassian API Tokens
  2. Click Create API token
  3. Give it a descriptive name (e.g., "gojira CLI")
  4. Copy the token - you won't see it again

Keep your token secure

API tokens provide full access to your Jira account. Never commit them to version control or share them publicly.

Next Steps