CLI Reference¶
Complete reference for all Gira commands and options.
Table of Contents¶
Ticket Management¶
gira ticket blame- Discover tickets associated with specific file lines.
Global Options¶
These options can be used with any command:
--help- Show help message and exit--version- Show version number and exit
Commands¶
gira ticket blame¶
Discover tickets associated with specific file lines.
Arguments:
files- File(s) to analyze for ticket references (required)- Type: array
- Examples: .gira/config.json, /path/to/file.txt, ./relative/path.md
Options:
-L, --lines- Line range (e.g., '10,20' or '10,+5')-
Default:
-
-f, --format- Output format: table, json, simple - Choices: text, json, table, csv
- Default: table
-
Examples: json, table
-
--ids-only- Show only ticket IDs (implies simple format) -
Type: boolean
-
--json- Output as JSON (shorthand for --format json) -
Type: boolean
-
-C, --context- Show N lines of context around blamed lines - Type: integer
-
Default:
-
--history- Show full history of tickets that touched specific lines (requires -L) -
Type: boolean
-
--no-cache- Bypass cache and force fresh blame analysis -
Type: boolean
-
--color- Enable syntax highlighting for JSON output (default: no color for AI compatibility) -
Type: boolean
-
--no-color- Explicitly disable syntax highlighting (default is already no color) - Type: boolean
Examples: