atl-jira

atl — Jira Commands

Quick start

# Search issues
atl jira search "project = PROJ AND status != Done ORDER BY updated DESC"

# Read an issue
atl jira get-issue PROJ-123

# Create an issue
atl jira create-issue --project PROJ --type Bug --summary "Login broken"

# Transition an issue
atl jira transition-issue PROJ-123 --transition "In Progress"

# Add a comment
atl jira add-comment PROJ-123 "Investigating this now"

---

atl jira search <jql>

Search Jira issues using JQL.

atl jira search "<jql>" [--limit N] [--offset N] [--fields field1,field2] [--json]

Options:

• --limit N (default: 20) — max results
• --offset N (default: 0) — skip N results
• --fields — comma-separated field names
• --json — force JSON output

Examples:

atl jira search "project = PROJ AND type = Bug AND status != Done"
atl jira search "assignee = currentUser() ORDER BY updated DESC"
atl jira search "project = PROJ AND updated >= -7d" --limit 50

JSON output:

{
  "issues": [
    {
      "key": "PROJ-123",
      "id": "10001",
      "summary": "Issue title",
      "status": "In Progress",
      "statusCategory": "indeterminate",
      "issueType": "Bug",
      "priority": "High",
      "assignee": "John Doe",
      "reporter": "Jane Smith",
      "created": "2024-01-15T10:30:00.000+0000",
      "updated": "2024-01-16T14:20:00.000+0000",
      "description": "Issue description in markdown",
      "labels": ["backend", "urgent"],
      "components": ["API"],
      "comments": [],
      "url": "https://company.atlassian.net/browse/PROJ-123"
    }
  ],
  "total": 42,
  "hasMore": true
}

---

atl jira get-issue <key>

Get full details of a Jira issue including description and comments.

atl jira get-issue <ISSUE-KEY> [--comments N] [--fields field1,field2] [--json]

Options:

• --comments N (default: 10) — max comments to include
• --fields — comma-separated field names
• --json — force JSON output