jean-tui

jean-tui is an AI-powered terminal interface for managing Git worktrees. It simplifies branch and worktree management with a keyboard-driven UI. Connects to Claude Code for AI assistance, integrates with tmux, and is written in Go.

[{"step":"Install and initialize jean-tui","action":"Install jean-tui via your package manager (e.g., `brew install jean-tui` or `go install github.com/your-repo/jean-tui@latest`). Initialize it in your Git project by running `jean-tui init` in the project root. Ensure your Git repository is clean (no uncommitted changes) before proceeding.","tip":"Run `jean-tui --version` to verify installation. If using tmux, ensure it’s running (`tmux ls`) to enable seamless pane switching."},{"step":"List and inspect worktrees","action":"Launch jean-tui in your project directory (`jean-tui`). Use the arrow keys to navigate between worktrees. Press `Enter` to select a worktree and view its details (latest commits, active sessions, and file changes).","tip":"Press `?` to see all available keyboard shortcuts. Use `j`/`k` to scroll through the list quickly."},{"step":"Perform actions on worktrees","action":"Highlight a worktree and press `d` to delete it, `c` to checkout a branch into a new worktree, or `p` to prune stale worktrees. Confirm actions with `y` when prompted.","tip":"For bulk actions, use `jean-tui prune` in the terminal to remove all stale worktrees at once."},{"step":"Integrate with your workflow","action":"Use jean-tui in tandem with tmux to manage worktrees across panes. For example, open jean-tui in one pane and a terminal in another to run Git commands. Connect to Claude Code for AI assistance by running `claude` in a tmux pane while jean-tui is active.","tip":"Bind jean-tui to a tmux key (e.g., `bind-key t run-shell 'jean-tui'`) for quick access."},{"step":"Generate reports or automate tasks","action":"Use the `--json` flag (e.g., `jean-tui --json list`) to output worktree data in JSON format. Pipe this to a script or Claude Code for further analysis, such as identifying unused branches or generating cleanup reports.","tip":"Combine with `jq` to filter output: `jean-tui --json list | jq '.[] | select(.lastActivity < \"2024-05-01\")'`"}]