WorkFlowOne isolated workspace per piece of work

A local-first, CLI-first tool that orchestrates git worktrees — with a live-status dashboard and tmux integration. See every workspace across your projects, review the diff, merge, and clean up from one cockpit.

Get Started

Why WorkFlow?

View on GitHub

wf — dashboard

WorkFlow — dashboard

❯ acme-api (2) ~/code/acme-api

branch state behind|ahead diff base

◆ ○ development clean

├─ 🤖 ● feature/login active ↓0|↑3 +84 -12 * development ▣

└─ ○ fix/cache-key clean ↓1|↑0 +0 -0 development

dotfiles (1) ~/code/dotfiles

branch state behind|ahead diff base

◆ ○ main clean

└─ ⏳ ● tmux-theme active ↓0|↑1 +20 -4 main

🤖 working ⏳ waiting ● active ○ clean ◆ base ▣ tmux open +added -removed * uncommitted

↑/↓ move · enter diff/menu · a add · e edit · o config · t term · c copy · m merge · x rm · r refresh · q quit

🌳

A worktree per task

wf add spins up a branch and an isolated git worktree as its own directory — run setup, copy and symlink files into it automatically, then open it in any editor wf finds installed. Switch tasks without stashing or rebuilding.

Create your first workspace

📊

Live cross-project dashboard

A TUI ledger of every project and its workspaces with live git status — ahead/behind, ±lines, dirty flag, and an active/clean state. Launch the trunk straight from its base row, manage projects, and review a scrollable colorized diff.

Explore the dashboard

🪟

tmux as a guest

Inside tmux, WorkFlow creates real windows in your current session — one per workspace — that you navigate with your own keys, each tab showing a live working/waiting agent icon. It never wraps or owns your session.

How tmux integration works

⌨️

CLI-first & scriptable

Every capability is a subcommand; the dashboard and sidebar are optional surfaces over the same engine. wf list --json makes the whole ledger easy to pipe into your own tooling.

Command reference

⚙️

Per-repo setup that just runs

An optional .workFlow.yaml sets the base branch, the worktree location, setup commands to run, and files to copy or symlink into every new worktree — so each workspace is ready the moment it exists.

Configure a repo

✅

Review, merge, clean up

Inspect a workspace's diff against its base, then merge it — WorkFlow merges the branch, removes the worktree, deletes the branch, and closes its tmux window in one step. Or rm to drop it without merging.

The workspace lifecycle