wtflow - Git GUI for Worktrees & AI Agents

A worktree-first Git client for agent workflows.

wtflow is an experimental fork of SourceGit. It treats Git worktrees as first-class workspaces and explores task governance, lifecycle visibility, and one external agent TUI session per worktree. It seamlessly integrates with the wtcraft machine protocol.

Project Status

wtflow is currently a research fork, not a stable SourceGit replacement. The first milestone is a read-only, default-open Worktrees panel that combines Git-native worktree facts with optional governance state from the wtcraft core.

Planned boundaries:

• Keep SourceGit's mature cross-platform Git client foundation.
• Make worktrees the primary unit for agent-oriented development.
• Allow at most one active external agent TUI session per worktree.
• Keep agent runtimes and terminal emulation outside the application.
• Preserve graceful operation when wtcraft is unavailable.

Screenshots

• The Worktree Panel - Manage your concurrent tasks and agent contracts effortlessly.

  

Why wtflow?

While traditional Git GUIs focus heavily on branch management within a single working directory, modern development often involves multiple simultaneous tasks and AI agents operating concurrently.

wtflow brings:

• First-Class Worktree Support: A dedicated panel to visualize, create, and switch between Git worktrees seamlessly.
• Agent Harness Visibility: Native visualization of .worktree-task.md contracts. The stage, agent role, and verification status displayed here are directly integrated with our sibling project wtcraft.
• wtcraft Protocol Integration: Interacts with the wtcraft CLI via its machine-readable JSON protocol to ensure the GUI perfectly mirrors the CLI state.
• Fast & Native: Built with Avalonia UI for incredible performance across macOS, Windows, and Linux.

Highlights

(Inherited and enhanced from SourceGit)

• Supports Windows / macOS / Linux
• Blazing Fast
• Visual commit graph
• Built-in light/dark themes
• Supports SSH access with each remote
• Comprehensive Git commands (Merge/Rebase/Reset/Revert/Cherry-pick...)
• Interactive rebase
• Built-in conventional commit message helper

Development & Setup

Make sure you have .NET 10 SDK installed.

Quick Start

# 1. Initialize submodules and restore NuGets
make setup

# 2. Build and launch the app
make run

Acknowledgments & Credits

wtflow is built upon the phenomenal foundation of SourceGit created by the SourceGit community.

We deeply appreciate their hard work, robust architecture, and open-source spirit. Without SourceGit, wtflow would not exist.

Thanks to all the people who contributed to the original project:

For detailed license information of third-party components, see THIRD-PARTY-LICENSES.md.