CLI Reference¶
Complete reference for all Gira commands and options.
Table of Contents¶
Epic Management¶
gira epic create- Create a new epic.
Global Options¶
These options can be used with any command:
--help- Show help message and exit--version- Show version number and exit
Commands¶
gira epic create¶
Create a new epic.
Arguments:
title- Epic title (required unless using --stdin) (optional)- Type: string
- Min length: 3
- Max length: 200
Options:
-d, --description- Epic description (use '-' for stdin, 'editor' to open editor)- Default:
-
Max length: 5000
-
--description-file- Read description from a file - Default:
-
Examples: ticket-description.md, docs/feature-spec.md, /tmp/bug-report.txt
-
-o, --owner- Epic owner email (defaults to git user email) - Default:
- Pattern:
^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ -
Examples: user@example.com, john.doe@company.org
-
-t, --target-date- Target completion date (YYYY-MM-DD) - Default:
- Pattern:
^\d{4}-\d{2}-\d{2}$ -
Examples: 2025-01-20, 2025-12-31
-
--output- Output format: text, json - Choices: text, json, table, csv
- Default: text
-
Examples: json, table
-
-q, --quiet- Only output epic ID -
Type: boolean
-
--stdin- Read JSON array of epics from stdin for bulk creation -
Type: boolean
-
--jsonl- Read JSONL (JSON Lines) format for streaming large datasets - Type: boolean
Examples: