Skip to content

CLI Reference

Complete reference for all Gira commands and options.

Table of Contents

Ticket Management

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 create

Create a new ticket.

gira ticket create [title] [options]

Arguments:

  • title - Ticket title (required unless using --stdin) (optional)
  • Type: string
  • Min length: 3
  • Max length: 200

Options:

  • -d, --description - Ticket description (use '-' for stdin, 'editor' to open editor)

  • Max length: 5000

  • --description-file - Read description from a file

  • Default:

  • Examples: ticket-description.md, docs/feature-spec.md, /tmp/bug-report.txt

  • -p, --priority - Priority level

  • Choices: low, medium, high, critical
  • Default: medium

  • Examples: medium, high

  • -a, --assignee - Assignee

  • Default:
  • Pattern: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

  • Examples: user@example.com, john.doe@company.org

  • -t, --type - Ticket type

  • Default: task

  • -l, --labels - Comma-separated labels

  • Default:

  • -e, --epic - Epic ID

  • Default:

  • --parent - Parent ticket ID for subtasks

  • Default:

  • -sp, --story-points - Story points estimate

  • Type: integer

  • Default:

  • -s, --status - Initial status (e.g., backlog, todo, in_progress)

  • Choices: backlog, todo, in_progress, review, done
  • Default:

  • Examples: backlog, todo, in_progress

  • -o, --output - Output format: text, json

  • Choices: text, json, table, csv
  • Default: text

  • Examples: json, table

  • -q, --quiet - Only output ticket ID

  • Type: boolean

  • --strict - Enforce strict assignee validation (no external assignees)

  • Type: boolean

  • --stdin - Read JSON array of tickets from stdin for bulk creation

  • Type: boolean

  • --jsonl - Read JSONL (JSON Lines) format for streaming large datasets

  • Type: boolean

  • --csv - Read CSV format from stdin for bulk creation

  • Type: boolean

  • --csv-delimiter - CSV delimiter character (default: comma)

  • Default: ,

  • --skip-invalid - Skip invalid rows and continue processing

  • Type: boolean

  • --fail-on-error/--no-fail-on-error - Exit with error if any row fails (default: true)

  • Type: boolean

  • Default: True

  • --cf - Custom field value in format 'name=value' (can be used multiple times)

  • Type: array
  • Default:

Examples:

gira ticket create "Fix login bug" --priority high --type bug

gira ticket create "Add user authentication" --description "Implement OAuth2" --epic EPIC-001

gira ticket create "Update documentation" --assignee john@example.com --labels "docs,urgent"