Epics

Epics

Manage epics and their child issues.

Prerequisites

• Authenticated profile (atlcli auth login)
• Jira permission: Browse Projects (read), Edit Issues (write)

List Epics

atlcli jira epic list --project ATLCLI

Options:

Flag	Description
--project	Filter by project key
--board	Filter by board ID
--done	Include completed epics

Examples

# List epics in a project
atlcli jira epic list --project ATLCLI

# List epics on a board
atlcli jira epic list --board 123

# Include completed epics
atlcli jira epic list --project ATLCLI --done

Get Epic

atlcli jira epic get ATLCLI-100

Create Epic

atlcli jira epic create --project ATLCLI --summary "User Authentication"

Options:

Flag	Description
--project	Project key (required)
--summary	Epic summary (required)
--description	Epic description

Epic Issues

List issues in an epic:

atlcli jira epic issues ATLCLI-100

Options:

Flag	Description
--status	Filter by status
--limit	Maximum results

Add Issues to Epic

Add one or more issues to an epic:

atlcli jira epic add ATLCLI-101 ATLCLI-102 ATLCLI-103 --epic ATLCLI-100

The issue keys are positional arguments, and --epic specifies the target epic.

Remove Issues from Epic

Remove issues from their epic:

atlcli jira epic remove ATLCLI-101

This removes the issue from its current epic.

Epic Progress

View completion status:

atlcli jira epic progress ATLCLI-100

Output:

Epic: ATLCLI-100 - User Authentication
Progress: 60% complete

Issues: 10 total
  Done:        6
  In Progress: 2
  To Do:       2

JSON Output

All commands support --json:

atlcli jira epic list --project ATLCLI --json

{
  "schemaVersion": "1",
  "epics": [
    {
      "key": "ATLCLI-100",
      "summary": "User Authentication",
      "status": "In Progress",
      "issueCount": 10,
      "doneCount": 6
    }
  ]
}

Related Topics

• Issues - Work with individual issues
• Boards & Sprints - Sprint management
• Analytics - Epic progress tracking