Skip to content

CLI Reference

Complete reference for all Gira commands and options.

Table of Contents

Other Commands

Global Options

These options can be used with any command:

  • --help - Show help message and exit
  • --version - Show version number and exit

Commands

gira operation status

Check the status of an async operation.

gira operation status <operation_id> [options]

Arguments:

  • operation_id - Operation ID to check (required)
  • Type: string

Options:

  • -o, --output - Output format: text, json
  • Choices: text, json, table, csv
  • Default: text
  • Examples: json, table

Examples:

gira operation status <operation_id>

gira operation list

List async operations.

gira operation list [options]

Options:

  • --active - Show only active operations

  • Type: boolean

  • -n, --limit - Maximum operations to show

  • Type: integer

  • Default: 10

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

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

Examples:

gira operation list

gira operation list --active

gira operation cancel

Cancel a running operation.

gira operation cancel <operation_id> [options]

Arguments:

  • operation_id - Operation ID to cancel (required)
  • Type: string

Options:

  • -f, --force - Skip confirmation
  • Type: boolean

Examples:

gira operation cancel <operation_id>

gira operation cancel <operation_id> --force

gira operation wait

Wait for an operation to complete.

gira operation wait <operation_id> [options]

Arguments:

  • operation_id - Operation ID to wait for (required)
  • Type: string

Options:

  • -t, --timeout - Timeout in seconds
  • Type: integer

  • Default: 300

  • -q, --quiet - Suppress progress output

  • Type: boolean

Examples:

gira operation wait <operation_id>

gira operation wait <operation_id> --quiet

gira operation resume

Resume operations from persistence.

gira operation resume [operation_id] [options]

Arguments:

  • operation_id - Specific operation to resume (optional)
  • Type: string

Options:

  • --all - Resume all incomplete operations
  • Type: boolean

Examples:

gira operation resume

gira operation resume --all

gira operation cleanup

Clean up old operation snapshots.

gira operation cleanup [options]

Options:

  • -d, --days - Delete operations older than N days
  • Type: integer
  • Default: 7

  • Examples: 7, 14, 30

  • --dry-run - Show what would be deleted

  • Type: boolean

Examples:

gira operation cleanup

gira operation cleanup --dry-run