CLI Reference

Complete reference for all Gira commands and options.

Table of Contents

Team Management

• gira team add - Add a new team member.

• gira team discover - Discover team members from Git commit history.

• gira team list - List all team members.

• gira team remove - Remove a team member.

Global Options

These options can be used with any command:

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

Commands

gira team list

List all team members.

gira team list [options]

Options:

• -r, --role - Filter by role

• Default:

• --active-only - Show only active members

• Type: boolean

• -f, --format - Output format

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

• Examples: json, table

• --json - Output as JSON (shorthand for --format json)

• Type: boolean

• --filter-json - JSONPath expression to filter JSON output (e.g., '$[?(@.active==true)].email')

• 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 team list

gira team list --format json

gira team list --active-only

---

gira team add

Add a new team member.

gira team add <email> [options]

Arguments:

• email - Email address of the team member (required)
• Type: string
• Pattern: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
• Examples: user@example.com, john.doe@company.org

Options:

• -n, --name - Display name

• Default:

• -u, --username - Username for @mentions

• Default:

• -r, --role - Role in the project

• Default: developer

• -a, --alias - Alias for quick assignment (can be used multiple times)

• Type: array

• Default:

• -i, --interactive - Interactive mode

• Type: boolean

Examples:

gira team add user@example.com

gira team add user@example.com --interactive

---

gira team remove

Remove a team member.

gira team remove <identifier> [options]

Arguments:

• identifier - Email, username, or alias of the team member to remove (required)
• Type: string

Options:

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

Examples:

gira team remove <identifier>

gira team remove <identifier> --force

---

gira team discover

Discover team members from Git commit history.

gira team discover [options]

Options:

• -l, --limit - Maximum number of commits to analyze
• Type: integer

• Default: 50

• --add-all - Add all discovered members without prompting

• Type: boolean

• --dry-run - Show what would be added without making changes

• Type: boolean

Examples:

gira team discover

gira team discover --add-all

---