Skip to content

CLI Reference

Complete reference for all Gira commands and options.

Table of Contents

Core Commands

  • gira init - Initialize a new Gira project in the current directory.

Global Options

These options can be used with any command:

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

Commands

gira init

Initialize a new Gira project in the current directory.

gira init [name] [options]

Arguments:

  • name - Project name (optional)
  • Type: string

Options:

  • -d, --description - Project description
  • Max length: 5000

  • -p, --prefix - Ticket ID prefix (2-4 uppercase letters)

  • Default:

  • -f, --force - Overwrite existing project

  • Type: boolean

  • --strict-workflow - Use traditional linear workflow instead of flexible transitions

  • Type: boolean

  • -w, --workflow - Workflow template: scrum, kanban, support-desk, bug-tracking, minimal, custom

  • Default:

  • --non-interactive - Run without prompts (all required options must be provided)

  • Type: boolean

Examples:

gira init
gira init --force