CLI Reference¶
Complete reference for all Gira commands and options.
Table of Contents¶
Ticket Management¶
gira ticket move- Move ticket(s) to a different status/swimlane.
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 move¶
Move ticket(s) to a different status/swimlane.
Arguments:
ticket_ids- Ticket ID(s) to move (use '-' to read from stdin) (optional)- Type: array
- Pattern:
^[A-Z]{2,4}-\d+$ -
Examples: GIRA-123, GCM-456, PROJ-1
-
target_status- Target status to move ticket to (required) - Type: string
- Pattern:
^\d{4}-\d{2}-\d{2}$ - Examples: 2025-01-20, 2025-12-31
Options:
-p, --position- Position in new column (1-based)- Type: integer
-
Default:
-
-o, --output- Output format: text, json - Choices: text, json, table, csv
- Default: text
-
Examples: json, table
-
-q, --quiet- Only output ticket ID -
Type: boolean
-
--dry-run- Preview the move without performing it -
Type: boolean
-
--git/--no-git- Stage the move using 'git mv' - Type: boolean
-
Default:
-
-f, --force- Skip confirmation prompt -
Type: boolean
-
--force-transition- Skip workflow validation and force the transition -
Type: boolean
-
--confirm- Force confirmation prompt even if configured to skip -
Type: boolean
-
-a, --assignee- Filter by assignee (use 'me' for current user) - Default:
- Pattern:
^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ -
Examples: user@example.com, john.doe@company.org
-
--from- Only move tickets from this status - Choices: backlog, todo, in_progress, review, done
- Default:
-
Examples: backlog, todo, in_progress
-
-e, --epic- Filter tickets by epic ID - Default:
- Pattern:
^EPIC-\d{3}$ -
Examples: EPIC-001, EPIC-002
-
-s, --sprint- Filter tickets by sprint ID (use 'current' for active sprint) - Default:
- Pattern:
^SPRINT-\d{3}$ -
Examples: SPRINT-001, SPRINT-002
-
-c, --comment- Add comment to moved tickets -
Default:
-
--assign- Assign tickets to user while moving -
Default:
-
--add-label- Add label to moved tickets -
Default:
-
--priority- Update priority while moving - Choices: low, medium, high, critical
- Default:
-
Examples: medium, high
-
--check-dependencies- Check for blocking dependencies -
Type: boolean
-
-b, --batch- Batch ID for undo operations -
Default:
-
--if-no-blockers- Only move if ticket has no unresolved blocking dependencies -
Type: boolean
-
--if-complete- Only move if ticket completion criteria are met -
Type: boolean
-
--if-allowed- Only move if workflow transition is allowed - Type: boolean
Examples: