sentei

A TUI tool for cleaning up stale git worktrees. Scan, select, and bulk-delete worktrees with parallel execution and clear progress feedback.

Features

• Interactive list with metadata (last commit date, branch, status)
• Multi-select with keyboard navigation
• Parallel deletion with real-time progress
• Safety: confirmation dialogs, warnings for dirty worktrees, branch protection
• Sorting, filtering, and dry-run mode

Installation

go install

go install github.com/abiswas97/sentei@latest

Build from source

git clone https://github.com/abiswas97/sentei.git
cd sentei
go build -ldflags "-X main.version=$(git describe --tags --always)" -o sentei .

Usage

Run inside a git repository with worktrees:

sentei                          # current directory
sentei /path/to/bare/repo       # specify repo path
sentei --dry-run                # print summary, no interactive TUI
sentei --version                # print version and exit
sentei --playground             # launch with a temporary test repo

Create a worktree

Use the interactive create flow, or provide the branch and base for a non-interactive run:

sentei create
sentei create --branch feature/my-change --base main --non-interactive

Repositories can declare private files that belong in every new worktree. Keep the source file in the bare-repository container, outside committed worktrees, and add rules to the container's .sentei.yaml:

worktree_files:
  - source: .sentei/private/codex-config.toml
    destination: .codex/config.toml
  - source: .sentei/private/tool.json
    destination: .tool/config.json
    overwrite: true

source is relative to the bare-repository container. destination is relative to each newly created worktree. Missing destination directories are created automatically. Existing destinations are preserved unless overwrite: true is explicit.

Both paths must be non-empty relative paths without .. components. Sentei rejects source symlinks that escape the container and any destination symlink. A missing source or failed copy is reported as a failed Setup step; Sentei keeps the created worktree and continues independent dependency and integration steps. File contents are never included in diagnostics.

worktree_files is automatic repository setup. Ecosystem env_files remains an independent, opt-in create option controlled by --copy-env.

CLI Flags

Flag	Description
--version	Print version and exit
--dry-run	Print worktree summary to stdout and exit
--playground	Create a temporary test repo with sample worktrees

Key Bindings

Key	Action
j / k / arrows	Navigate up/down
PgUp / PgDn	Page up/down
Space	Toggle selection
a	Select/deselect all
s	Cycle sort (age, branch)
S	Reverse sort direction
/	Filter by branch name
Enter	Confirm deletion of selected
y / n	Yes/no in confirmation dialog
Esc	Go back / clear filter
q / Ctrl+C	Quit

Status Indicators

Indicator	Meaning
[ok]	Clean — no uncommitted changes
[~]	Dirty — has uncommitted changes
[!]	Has untracked files
[L]	Locked
[P]	Protected branch (cannot be deleted)

Protected branches: main, master, develop, dev.

License

MIT