jira

Use jira to manage Jira issues, sprints, and boards. Requires API token setup.

Setup (once)

1. Generate an API token: https://id.atlassian.com/manage-profile/security/api-tokens
2. Export it: export JIRA_API_TOKEN="your-token" (add to ~/.zshrc for persistence)
3. Initialize: jira init --server https://your-org.atlassian.net --login you@email.com --installation cloud

Common commands

Issues

• List issues: jira issue list -p PROJECT
• View issue: jira issue view PROJ-123
• Create issue: jira issue create -p PROJECT -t "Task" -s "Summary" -b "Description"
• Edit issue: jira issue edit PROJ-123 -s "New summary"
• Assign issue: jira issue assign PROJ-123 "user@email.com"
• Transition issue: jira issue move PROJ-123 "In Progress"
• Comment: jira issue comment add PROJ-123 "My comment"
• Search (JQL): jira issue list -q "project = MKT AND status = 'To Do'"

Sprints

• List sprints: jira sprint list -p PROJECT
• View active sprint: jira sprint list -p PROJECT --state active
• Sprint issues: jira sprint list -p PROJECT --state active --plain

Boards

• List boards: jira board list -p PROJECT

Epics

• List epics: jira epic list -p PROJECT
• View epic: jira epic view PROJ-100

Projects

• List projects: jira project list

Output formats

• --plain — Tab-separated, no colors (best for scripting)
• --columns key,summary,status — Select columns
• --no-truncate — Don’t truncate long fields

Tips

• Set default project in config: ~/.config/.jira/.config.yml
• Use JQL for complex queries: -q "assignee = currentUser() AND status != Done"
• Open in browser: jira open PROJ-123

Notes

• Confirm with user before creating/editing/transitioning issues
• For bulk operations, show what will change before executing