Skip to content

CLI Reference

Complete reference for all Gira commands and options.

Table of Contents

Archive 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 archive list

List archived tickets with optional filtering.

gira archive list [options]

Options:

  • -m, --month - Show tickets from specific month (YYYY-MM)

  • Default:

  • -s, --search - Search in ticket title and description

  • Default:

  • -l, --limit - Maximum number of tickets to show

  • Type: integer

  • Default:

  • -f, --format - Output format

  • Type: enum
  • Choices: TABLE, JSON, YAML, CSV, TSV, TEXT, IDS
  • Default: table

  • Examples: json, table

  • --stats - Show archive statistics

  • Type: boolean

  • --filter-json - JSONPath expression to filter JSON output (e.g., '$[?(@.priority=="high")].id')

  • Default:

  • --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:

gira archive list

gira archive list --format json

gira archive list --stats