majiayu000 Managing Jira
Official Atlassian CLI for Jira work items and comments.
Basic Syntax
acli jira [COMMAND] [OPTIONS]
Commands
Work Items
View work item details
acli jira workitem view --key "<issue-key>"
# Example:
acli jira workitem view --key "CM-2766"
List work items
acli jira workitem list [OPTIONS]
# Options:
# --jql TEXT JQL query to filter work items
# --max-results INT Maximum number of results
# Examples:
acli jira workitem list --jql "project = CM AND status = 'In Progress'"
acli jira workitem list --max-results 10
Create work item
acli jira workitem create [OPTIONS]
# Options:
# --summary TEXT Work item summary (required)
# --project TEXT Project key (required)
# --type TEXT Work item type (default: Task)
# --description TEXT Work item description
# Example:
acli jira workitem create --summary "Fix OAuth bug" --project "CM" --type "Bug"
Edit work item
acli jira workitem edit --key "<issue-key>" [OPTIONS]
# Options:
# --summary TEXT New summary
# --description TEXT New description
# Example:
acli jira workitem edit --key "CM-2766" --summary "Updated OAuth implementation"
Transition work item status
acli jira workitem transition --key "<issue-key>" --status "<status>"
# Example:
acli jira workitem transition --key "CM-2766" --status "In Progress"
Comments
Add comment
acli jira workitem comment create --key "<issue-key>" --body "<comment-text>"
# Examples:
acli jira workitem comment create --key "CM-2766" --body "Updated the implementation"
# Multi-line comment:
acli jira workitem comment create --key "CM-2766" --body "$(cat << 'EOF'
## Resumen Ejecutivo
Se corrigió bug crítico en OAuth...
EOF
)"
List comments
acli jira workitem comment list --key "<issue-key>"
# Example:
acli jira workitem comment list --key "CM-2766"
Common Patterns
Post manager summary to Jira
# Post Spanish manager summary to Jira issue
acli jira workitem comment create --key "CM-2766" --body "$(cat << 'EOF'
## Resumen Ejecutivo
Se corrigió bug crítico en autenticación OAuth que afectaba...
**Impacto:**
- Sistema de autenticación estabilizado
- Reducción de errores de login en 95%
**Próximos Pasos:**
- Monitorear métricas por 48h
- Documentar cambios
EOF
)"
Check work item before working
# View full work item details
acli jira workitem view --key "CM-2766"
# List recent comments
acli jira workitem comment list --key "CM-2766"
Query for related work items
# Find all in-progress issues in project
acli jira workitem list --jql "project = CM AND status = 'In Progress'"
# Find issues assigned to you
acli jira workitem list --jql "assignee = currentUser()"
Common Errors
Invalid work item key
ERROR: Issue does not exist or you do not have permission to see it
SOLUTION: Verify the issue key format (e.g., "CM-2766") and ensure you have access to the project.
Getting Help
Use --help on any command:
acli jira --help
acli jira workitem --help
acli jira workitem view --help
acli jira workitem comment --help