Skip to content

Implementation Status

Current status of Gira features and roadmap for future development.

✅ Completed Features

Core Infrastructure

  • ✅ Pydantic v2 models for data validation
  • ✅ Typer CLI framework
  • ✅ Modular command structure
  • ✅ Comprehensive test suite (88% coverage)
  • ✅ File-based JSON storage
  • ✅ Git-friendly design

Project Management

  • ✅ gira init - Initialize new projects
  • ✅ Project configuration with custom prefixes
  • ✅ Board configuration with swimlanes and transitions

Ticket Management

  • ✅ gira ticket create - Create tickets with all fields
  • ✅ gira ticket list - List with filtering and sorting
  • ✅ gira ticket show - Display ticket details
  • ✅ gira ticket update - Update any ticket field
  • ✅ gira ticket move - Move between statuses with validation

Board Visualization

  • ✅ gira board - Kanban board display
  • ✅ WIP limit indicators
  • ✅ Filtering by assignee, type, priority, labels
  • ✅ Compact view mode
  • ✅ Color-coded priorities and types

Developer Experience

  • ✅ Rich terminal output with tables and colors
  • ✅ Helpful error messages
  • ✅ Git user integration for reporter/assignee
  • ✅ Comprehensive documentation

🚧 In Progress

Documentation

  • 🚧 Complete user guide
  • 🚧 API documentation
  • 🚧 Contributing guide

📋 Planned Features

High Priority

Sprint Management

  • ⏳ gira sprint create - Create new sprints
  • ⏳ gira sprint list - List all sprints
  • ⏳ gira sprint start - Activate a sprint
  • ⏳ gira sprint close - Complete sprint with retrospective

Search Functionality

  • ⏳ gira search - Full-text search across tickets
  • ⏳ Advanced query syntax
  • ⏳ Search by date ranges

Medium Priority

Epic Management

  • ⏳ gira epic create - Create epics
  • ⏳ gira epic list - List all epics
  • ⏳ gira epic update - Update epic details
  • ⏳ Link tickets to epics

Comments System

  • ⏳ gira comment add - Add comments to tickets
  • ⏳ gira comment list - View ticket comments
  • ⏳ gira comment edit - Edit own comments
  • ⏳ Markdown support in comments

Configuration Management

  • ⏳ gira config - View/edit configuration
  • ⏳ Custom field definitions
  • ⏳ Workflow customization

Low Priority

Import/Export

  • ⏳ gira export - Export to JSON, CSV, Markdown
  • ⏳ gira import - Import from JSON/CSV
  • ⏳ Jira integration

Advanced Features

  • ⏳ Git hooks for automatic updates
  • ⏳ Shell completion support
  • ⏳ Time tracking
  • ⏳ Attachments support
  • ⏳ Web UI (separate project)

🔄 Version History

v0.2.0 (Current Release)

  • Core ticket management (create, list, show, update, move, order)
  • Kanban board visualization with filtering
  • Epic management (create, list, show, update)
  • Sprint management (create, list, show, update)
  • Comment system (add, list)
  • Archive functionality (ticket, done, old, list, restore)
  • Shell completion support
  • Ticket dependencies (add-dep, remove-dep, deps, tree)
  • Configuration management (set, get, reset)

v0.2.0 (Planned)

  • Enhanced search with full-text indexing
  • Performance optimizations for large projects
  • Advanced shell completion with ID auto-completion
  • Import/export functionality

v0.3.0 (Future)

  • Git hooks and automation
  • Time tracking
  • Advanced workflow customization
  • Web UI integration

📊 Feature Comparison

Feature Gira Jira GitHub Issues Linear
Offline Support ✅ ❌ ❌ ❌
Git Native ✅ ❌ ✅ ❌
Plain Text Storage ✅ ❌ ❌ ❌
Kanban Board ✅ ✅ ✅ ✅
Sprints 🚧 ✅ ✅ ✅
Epics 🚧 ✅ ❌ ✅
Comments 🚧 ✅ ✅ ✅
Search 🚧 ✅ ✅ ✅
Custom Fields 🚧 ✅ ❌ ✅
Time Tracking ⏳ ✅ ❌ ✅
API ⏳ ✅ ✅ ✅
Free & Open Source ✅ ❌ ❌ ❌

🎯 Design Principles

  1. Simplicity First: Features should be intuitive and require minimal configuration
  2. Git Integration: All data changes should be Git-friendly
  3. Offline by Default: No network dependencies for core features
  4. AI-Friendly: Structured data that AI agents can easily parse and modify
  5. Performance: Fast operations even with thousands of tickets

🤝 Contributing

We welcome contributions! Priority areas:

  1. Sprint Management: Help implement sprint commands
  2. Search: Build the search infrastructure
  3. Testing: Increase test coverage to 95%+
  4. Documentation: Improve user guides and examples
  5. Performance: Optimize for large projects

See Contributing Guide (coming soon) for details.

📅 Release Schedule

  • Monthly Releases: New features and improvements
  • Weekly Patches: Bug fixes and documentation updates
  • Breaking Changes: Only in major versions (v1.0, v2.0, etc.)

🐛 Known Issues

  1. Large boards (100+ tickets) may have display issues in narrow terminals
  2. No built-in merge conflict resolution for concurrent edits
  3. Limited to English language currently

📞 Feedback

Have ideas or found bugs? Please: - Open an issue on GitHub - Join our discussions - Submit a pull request

Your feedback shapes Gira's future!