v0.29.0¶

Release Date: 2026-04-11

This is a major release introducing the gojira CLI, package refactoring for a cleaner API, comprehensive documentation, and test coverage.

Highlights¶

New gojira CLI with search, get, patch, export, fields, and stats commands
Package refactoring for cleaner imports: jirarest → rest, jiraxml → xml, jiraweb → web
MkDocs documentation site with Material theme at grokify.github.io/gojira

Breaking Changes¶

Package Imports Changed¶

The package structure has been simplified for a cleaner API:

Before	After
`github.com/grokify/gojira/jirarest`	`github.com/grokify/gojira/rest`
`github.com/grokify/gojira/jiraxml`	`github.com/grokify/gojira/xml`
`github.com/grokify/gojira/jiraweb`	`github.com/grokify/gojira/web`

Migration: Update your import statements:

// Before
import "github.com/grokify/gojira/jirarest"

// After
import "github.com/grokify/gojira/rest"

New Features¶

gojira CLI¶

A new command-line interface optimized for both AI agents and humans.

Installation¶

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

Commands¶

Command	Description
`search`	Search issues with JQL
`get`	Get one or more issues by key
`patch`	Update issue fields and labels
`export`	Export issues to JSON or XLSX
`fields`	List and filter custom fields
`stats`	Show issue statistics grouped by field

Output Formats¶

JSON (default) - Machine-readable for scripting
Table - Human-readable ASCII tables
TOON - Token-Optimized Object Notation for LLMs (~8x more efficient)

Examples¶

# Set authentication
export JIRA_URL=https://your-instance.atlassian.net
export JIRA_USER=your-email@example.com
export JIRA_TOKEN=your-api-token

# Search issues
gojira search --jql "project = FOO AND status = Open"

# Get issue details
gojira get ISSUE-123

# Show statistics
gojira stats --jql "project = FOO" --by status --format table

# Update an issue
gojira patch ISSUE-123 --set priority=High --add-label urgent

# Export to Excel
gojira export --jql "project = FOO" --xlsx report.xlsx

stats Command¶

Aggregate issue counts by any field with multiple output formats.

# Count by status (table output)
gojira stats --jql "project = FOO" --by status --format table

# Output:
# VALUE          COUNT      %
# Open              45   30.0%
# In Progress       30   20.0%
# Done              75   50.0%
# ------         ------  ------
# TOTAL            150  100.0%

# Count by custom field (TOON output for LLMs)
gojira stats --jql "project = FOO" --by customfield_10001 --format toon

Supported grouping fields:

status, type, priority, assignee, project, resolution
Any custom field: customfield_XXXXX

patch Command¶

Update issue fields with dry-run support.

# Set fields
gojira patch ISSUE-123 --set summary="New title" --set priority=High

# Manage labels
gojira patch ISSUE-123 --add-label reviewed --remove-label needs-review

# Preview changes without executing
gojira patch ISSUE-123 --set summary="Test" --dry-run

# Complex updates via JSON
gojira patch ISSUE-123 --json '{"fields":{"assignee":{"name":"jdoe"}}}'

export Command¶

Export issues to JSON or XLSX with parent issue support.

# Export to JSON
gojira export --jql "project = FOO" --json issues.json

# Export to Excel with parents
gojira export --jql "project = FOO" --include-parents --xlsx report.xlsx

# Convert existing JSON to XLSX
gojira export --from-json issues.json --xlsx report.xlsx

fields Command¶

Discover and filter custom fields.

# List all custom fields
gojira fields --custom-only

# Find by name
gojira fields --name "Epic"

# Get Epic Link field specifically
gojira fields --epic-link

Documentation¶

New MkDocs documentation site with:

CLI Reference - Complete command documentation with examples
SDK Guide - Client creation, issue operations, JQL builder
AI Agents Guide - Best practices for LLM integration
JQL Examples - Common query patterns

Visit: grokify.github.io/gojira

Tests¶

Added comprehensive tests for the rest package:

Unit tests for IssueMore, IssueService
Integration tests (require JIRA_* environment variables)

Commits¶

Type	Description	Commit
Breaking	Package imports changed	`5fcf3ed`
Added	`gojira` CLI	`10b40a2`
Added	`stats` command	`a910dee`
Added	`patch`, `export`, `fields` commands	`910e502`
Docs	MkDocs documentation site	`c9b2902`
Docs	README updates	`5b7c648`
Tests	Unit and integration tests	`12bf737`