Skip to content

ginko epic

Usage

ginko epic [options]

Description

Creates and manages epics — large bodies of work broken down into sprints and tasks. The epic creation flow is AI-guided: ginko helps you define goals, scope, and sprint breakdown through conversation.

Options

Flag	Description
`--list`	List existing epics
`--view`	View epic details with sprint progress
`--sync`	Sync epic to graph database

Examples

# Create a new epic (AI-guided)
ginko epic

# List all epics
ginko epic --list

# View epic details
ginko epic --view

# Sync to graph
ginko epic --sync

Output

Creates files following the entity naming convention (ADR-052):

File	Example
Epic	`docs/epics/EPIC-005-auth-system.md`
Sprints	`docs/sprints/SPRINT-e005-s01-jwt-setup.md`

Entity naming

Entity	Format	Example
Epic	`e{NNN}`	`e005`
Sprint	`e{NNN}_s{NN}`	`e005_s01`
Task	`e{NNN}_s{NN}_t{NN}`	`e005_s01_t01`

ginko sprint — Manage sprints within epics
ginko task — Manage individual tasks
ginko push — Push epic to graph