User Guide

Learn how to use all of Gira's features for project management.

📖 Contents

Core Features

• tickets.md - Creating and managing tickets
• epics.md - Organizing work with epics
• sprints.md - Time-boxed development cycles
• query-language.md - Powerful search and filtering
• query-cookbook.md - Practical query examples

Analytics

• metrics.md - Project metrics, velocity, and analytics

Advanced Features

• advanced-features.md - Context, workflow, and graph commands
• Hook System - Automate workflows with event-driven hooks
• Hook Examples - Real-world automation examples

Collaboration

• comments.md - Comments and discussions
• attachments.md - File and link attachments
• subtasks.md - Subtasks and dependencies

Workflows

• workflows.md - Custom workflows and swimlanes

🎯 Common Tasks

Create a ticket

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

View the board

gira board

Start a sprint

gira sprint create "Sprint 1" --duration 14

Search with queries

# Find your high priority work
gira ticket list --query "assignee:me() AND priority:high"

# Find tickets ready for review
gira ticket list --query "status:review"

# Find recent bugs
gira ticket list --query "type:bug AND created_at:>=days_ago(7)"

Automate with hooks

# Set up automation
gira ext init

# Get Slack notifications for new tickets
gira ext install ticket-created

# Auto-create git branches when starting work
gira ext install ticket-moved