Skip to content

Gira – AI-First Project Management for Your Repo

Gira is a Git-native project management system built for the age of AI-assisted software development. It’s more than a ticket tracker — it’s a platform where agentic coding agents (Claude, Gemini, etc.) can create, manage, and complete tickets directly inside your repository, alongside your code.

🚀 Why Gira?

Traditional tools like Jira or GitHub Projects were designed for humans clicking around in a browser. Gira flips that model — it’s AI-first, developer-friendly, and lives in your Git repo:

  • AI-Native: Seamless integration with agentic coding agents via MCP server (30+ tools for tickets, boards, sprints, epics, etc.).
  • Git-Native: Tickets, boards, and config live as JSON in .gira/ — version-controlled with your code.
  • Offline-First: Works anywhere, anytime. Push changes when you’re online.
  • Beautiful CLI: Rich terminal interface for humans; machine-readable JSON for AIs.
  • Extensible: Hooks, integrations, and open-source flexibility.
  • Human-Ready: Web UI planned, CLI ready today.

🧠 Example: AI Planning + Implementation

This is where Gira stands apart — an AI can plan and build with you.

# Create a new repo and init Gira
mkdir snake-game && cd snake-game
git init
gira init "Snake Game Project"

Step 1: AI reads .gira/ docs and project config. Step 2: You say:

"Create an epic for a browser-based Snake Game with detailed tickets."

Step 3: AI creates:

  • EPIC-001: Snake Game Browser Implementation
  • 16 tickets covering core logic, UI/UX, features, and enhancements.

Step 4: You say:

"Implement SG-1."

Step 5: AI writes index.html, styles.css, game.js, and marks SG-1 Done in the board.

gira board
# Backlog (15) | Ready (0) | In Progress (0) | Done (1)

Everything — code and project state — is in Git.

📦 Quick Start

# Install Gira
pip install gira

# Initialize your project
gira init "My Project"

# Set up AI documentation
gira ai setup

Then open Claude, Gemini, or your MCP client and start creating epics & tickets in plain language.

📊 Current Status

Core Features (Ready Today):

  • ✅ Git-Native Storage – Tickets, boards, epics, and config live in .gira/, version-controlled with your code.
  • ✅ CLI Interface – Create, edit, move, and list tickets, epics, and sprints via rich terminal UI.
  • ✅ MCP Server for AI Agents – 30+ tools for ticket management, boards, epics, sprints, and configuration.
  • ✅ AI Agent Documentation – Auto-generates AI-specific guides (CLAUDE.md, GEMINI.md, etc.) when initializing a project.
  • ✅ Workflow Templates – Scrum, Kanban, Bug Tracking, Support Desk, Minimal, or fully custom.
  • ✅ Customizable Workflows – Editable swimlanes, statuses, and transitions.
  • ✅ Board Visualization – Kanban view in terminal, with filtering and sorting.
  • ✅ Offline-First Operation – Full functionality without an internet connection.
  • ✅ Hybrid Directory Structure – Scales to thousands of tickets without Git performance loss.
  • ✅ Hooks System – Trigger automation and integrations on project events.

In Progress / Planned:

  • 🛠️ Web Interface for Humans – Browser-based view and editing for tickets, boards, and epics.
  • 🛠️ Expanded Integrations – Jira import/export, GitHub Issues sync, CI/CD automation templates.

💡 Built for the AI Era

With Gira, your AI agent isn’t just a code assistant — it’s a project manager, planner, and teammate. It keeps reasoning, context, and progress in sync with your codebase, so humans and AIs stay on the same page.

Built with ❤️ for developers & agents by GoatBytes.IO.