Quick Start

This guide will get you from zero to managing your first project in under 5 minutes.

Initialize a Project

Navigate to your git repository:

cd ~/my-project
progit init

This creates a .project/ directory with:

• config.toml — Project settings
• issues/ — Issue tracking database
• sprints/ — Sprint planning data
• kanban/ — Board configuration

Launch the TUI

Start GroGit (the ProGit TUI):

progit tui

Or use the shorthand:

pgit

Your First Issue

From the TUI:

1. Press i to open the Issues panel
2. Press n to create a new issue
3. Enter title: “Set up project documentation”
4. Press Enter to save

Or use the CLI:

progit issue create "Set up project documentation" \
    --label=setup \
    --priority=high

Create a Sprint

progit sprint create "Sprint 1" \
    --weeks=2 \
    --goal="Complete MVP features"

Use the Kanban Board

In the TUI:

1. Press k for Kanban view
2. Navigate with j/k (down/up)
3. Press l to move right (To Do → In Progress → Done)
4. Press h to move left

Virtual Branches

Work on multiple branches simultaneously:

# Create virtual branches
progit branch virtual feature-auth
progit branch virtual feature-ui

# Switch between them
progit branch switch feature-auth

# Work independently
git commit -m "Add auth middleware"
progit branch switch feature-ui

AI Agent

Ask the AI for help:

# In TUI, press `a` for AI panel
# Or CLI:
progit ai "suggest commit message"
progit ai "explain this error"
progit ai "refactor this function"

Next Steps

• Configure ProGit
• Learn Keybindings
• Install Plugins

Common Commands

Command	Description
progit tui	Launch TUI
progit issue list	List all issues
progit kanban	Open kanban view
progit sprint status	Current sprint status
progit sync	Sync with remote forge