v1.4.1

What's Changed

Bug Fix

• Fixed: jcfa search now returns custom fields (Team, Quarter, etc.) by default

New Feature

• Added: --fields flag to specify which fields to return

Details

Previously, search only returned a hardcoded list of standard fields (summary, status, assignee, etc.), while get returned all fields including custom fields. This inconsistency has been fixed.

Usage

# Returns all fields including custom fields (new default)
jcfa search "project = PROJ"

# Return only specific fields (for performance)
jcfa search "project = PROJ" --fields summary,status,customfield_10014

Changed

• pkg/jira/search.go: Use *all instead of hardcoded field list when no specific fields requested
• cmd/search.go: Added --fields flag for selective field retrieval

v1.4.0 - Project Rename Release

jcfa v1.4.0 - Project Rename Release

jira-cli is now jira-cli-for-agents (jcfa)

This release renames the project to better reflect its purpose: a Jira CLI optimized for AI agents and automation workflows.

⚠️ Breaking Changes

Component	Before	After
Command	jira-cli	jcfa
Config directory	~/.jira-cli/	~/.jcfa/
Go module	github.com/sanisideup/jira-cli	github.com/sanisideup/jira-cli-for-agents
Keyring service	jira-cli	jcfa

Migration

# Migrate your config
mv ~/.jira-cli ~/.jcfa

# Update your scripts
# jira-cli search "project=PROJ"  →  jcfa search "project=PROJ"

Why the Rename?

The new name clarifies jcfa's unique position in the Jira CLI ecosystem:

Tool	Focus
jcfa	Automation-first (AI agents, CI/CD, scripts)
jira-cli	Human-first (interactive TUI)
Atlassian CLI	Admin-first (org management)

What's New

Documentation

• Added "Why jcfa?" comparison section to README
• Updated all documentation with new command name

---

Full Changelog: v1.3.0...v1.4.0

v1.3.0 - Security & Agent Safety

What's New in v1.3.0

This release adds significant security improvements and agent safety features, inspired by steipete/gogcli.

🔐 Secure Credential Storage

Store API tokens securely using OS-native keyring integration:

• macOS: Keychain
• Windows: Credential Manager
• Linux: Secret Service (GNOME Keyring, KWallet)
• Fallback: Encrypted file for CI/headless environments

# Automatic during setup
jira-cli configure
# → "Store API token securely in system keyring? [Y/n]"

# Or configure via environment
export JIRA_KEYRING_BACKEND=keychain  # or "file"
export JIRA_KEYRING_PASSWORD='...'    # required for file backend

🛡️ Command Allowlist (Agent Safety)

Restrict commands for sandboxed or AI-assisted execution:

# Read-only mode - blocks all write operations
export JIRA_READONLY=1

# Custom allowlist - only specific commands allowed
export JIRA_COMMAND_ALLOWLIST="get,search,list,fields"

New allowlist command for runtime management:

jira-cli allowlist status    # View current configuration
jira-cli allowlist commands  # List commands by category
jira-cli allowlist check X   # Test if command X is allowed
jira-cli allowlist enable    # Show enable instructions

📖 AGENTS.md

New comprehensive guide for AI agents and contributors covering:

• Project structure documentation
• Coding conventions
• Security guidelines
• Environment variables reference

---

Full Changelog

Added

• Secure credential storage (pkg/secrets/)
• Command allowlist system (pkg/allowlist/)
• allowlist CLI command with subcommands
• AGENTS.md documentation

Changed

• configure command now offers keyring storage
• Root command validates against allowlist before execution

Technical

• 844 lines of allowlist tests
• 261 lines of secrets tests
• Comprehensive documentation updates

---

Full Changelog: v1.2.0...v1.3.0

v1.2.0 - Link Commands & Subtasks

Link Commands & Subtasks - 2026-01-26

Added

Enhanced Link Command Group

• link create: New explicit subcommand for creating links between issues
  • Usage: jira-cli link create PROJ-123 PROJ-456 --type Blocks
• link types: List all available link types in your Jira instance
  • Shows name, inward description, and outward description
  • Supports --json output
• link list: List all links on a specific issue
  • Shows link ID, direction (→/←), type, linked issue, status, and summary
  • Supports --json output
• link delete: Delete a link by its ID
  • Requires --confirm flag for safety
  • Supports --json output

Subtask Creation

• --parent flag on create command for creating subtasks
  • Usage: jira-cli create --template task --data task.json --parent PROJ-123
  • Validates parent issue exists
  • Prevents creating sub-subtasks (parent cannot be a subtask)
  • Works with --dry-run for validation
  • Short flag: -p

Changed

• Link command restructured as a command group with subcommands
• Backward compatibility maintained: Legacy jira-cli link PROJ-123 PROJ-456 --type Blocks syntax continues to work

Technical Details

• New GetIssueLinks() method in pkg/jira/link.go for retrieving issue links
• New DeleteIssueLink() method in pkg/jira/link.go for deleting links
• Updated IssueLink model with ID and Self fields
• New IssueParent model for subtask parent references
• Added setupParentIssue() validation in cmd/create.go

v1.1.0 - Enhanced Get Command

Enhanced Get Command - 2026-01-26

Added

Enhanced get Command

• Description Display: Descriptions are now properly parsed from Atlassian Document Format (ADF) to plain text
  • Supports paragraphs, headings, code blocks, lists, blockquotes, tables, and more
  • Code blocks show language indicators (e.g., [json])
  • Bullet and numbered lists render with proper formatting
  • @mentions, emojis, and smart links are preserved
• Attachments Display: Shows attachment list with filename, size, author, and date
• Linked Issues (--links, -l): Display linked issues with direction arrows and status
• Subtasks (--subtasks, -s): Display subtasks with status and summary
• Comments (--comments, -c): Fetch and display issue comments with ADF parsing
• Full View (--full, -f): Show all optional sections at once

New Files

• pkg/jira/adf.go - Comprehensive Atlassian Document Format parser
• pkg/jira/adf_test.go - 19 unit tests for ADF parser

Changed

• get command output format improved with two-column layout and 80-char separators
• Epic link detection now checks multiple common field IDs
• Labels displayed comma-separated on a single line

Fixed

• Description field now properly renders rich text content instead of showing raw ADF JSON
• Proper handling of nil/empty descriptions and attachments

Technical Details

• ADF parser supports: doc, paragraph, heading, codeBlock, blockquote, bulletList, orderedList, listItem, text, hardBreak, mediaSingle, mediaGroup, rule, table, tableRow, tableHeader, tableCell, inlineCard, mention, emoji
• Comments are fetched via separate API call only when --comments or --full flag is used (lazy loading)
• Short flags can be combined (e.g., -lsc for links + subtasks + comments)

v1.0.0 - Initial Release

Initial Release - 2026-01-23

This is the first stable release of jira-cli, a command-line interface for Jira Cloud designed for developer productivity and AI-assisted workflows.

Highlights

• Complete CRUD operations for Jira issues
• Batch creation with automatic epic linking
• Template system for common issue types
• Custom field support with aliases
• JQL search capabilities
• Comprehensive documentation

Core Features

Issue Operations

• Single issue creation with templates
• Batch issue creation (supports up to 50 issues per API request, auto-chunks larger batches)
• Get issue details by key
• Update issue fields
• Search issues using JQL
• List recent issues with filters
• Add comments to issues
• Transition issues to new status
• Link issues (Blocks, Relates, Duplicate, Epic)

Field Management

• Custom field discovery (fields list)
• Field alias mapping (fields map)
• Automatic field resolution in update commands
• Support for all standard Jira field types

Template System

• Built-in templates: Epic, Story, Bug, Charter
• Template initialization (template init)
• Go text/template syntax support
• Default value handling
• JSON rendering helpers

Schema Validation

• Pre-creation validation using Jira metadata API
• Required field checking
• Field type validation
• Allowed value validation
• Detailed error messages

Batch Operations

• Epic creation with automatic story linking
• Progress tracking with visual progress bar
• Reference resolution system (@epic1 → actual key)
• Dry-run mode for validation
• Aggregated results reporting
• Error handling per item

Getting Started

# Install
go install github.com/sanisideup/jira-cli@latest

# Configure
jira-cli configure

# Create issues
jira-cli batch create issues.json

For detailed usage instructions, see the README.