Skip to main content

​
Overview

When you run git why log, tree, or search in a terminal (TTY), GitWhy opens an interactive TUI built with Bubble Tea and Lip Gloss.

​
Home

The home screen shows your repo summary and a welcome prompt to get started.
TUI home screen with repo summary and welcome message

​
Log view

Or type /log from the TUI home screen. Lists all saved contexts with navigation. Use arrow keys to browse, Enter to view details.
TUI log view with context list, IDs, dates, and titles
Browse all saved contexts with their linked commits, agents, and domains.

​
Tree view

Or type /tree from the TUI home screen. Navigate the domain/topic hierarchy. Expand and collapse domains to explore your context tree.
TUI tree view showing domain/topic hierarchy
Navigate contexts organized by domain and topic across branches.

​
Search view

Or type /search from the TUI home screen. Interactive search with real-time results as you type.
TUI search view with real-time results
Search across all contexts by keyword — results show commit links, domains, and agents.

​
Context detail

Select any context to see the full structured markdown with syntax highlighting.
TUI context detail view showing full structured content
View the full context with metadata, story, reasoning, phases, commits, and files modified — scroll with arrow keys, press Esc to go back.

​
Keyboard shortcuts

​
Non-interactive mode

When piped or in a non-TTY environment, commands output plain text instead of the TUI:
This makes GitWhy scriptable and composable with other CLI tools.

​
See also