WTM Worktree Manager

WTM (WorkTree Manager) is a Rust CLI and TUI for working with Git worktrees. It keeps local repositories organised under a dedicated .wtm workspace directory, lets you spin up additional worktrees quickly, and exposes a terminal-based dashboard for working across branches without leaving the keyboard.

Features

• Workspace scaffold: wtm init prepares a .wtm directory with metadata and default configuration.
• Worktree lifecycle: wtm worktree add/list/remove wraps common Git worktree commands and keeps paths predictable.
• TUI dashboard: wtm without arguments launches an interactive dashboard showing worktrees, embedded terminals, quick actions, and Jira ticket suggestions.
• GUI dashboard (experimental): wtm gui launches a desktop interface for managing worktrees, opening embedded PTY-backed terminal tabs, and triggering quick actions with the mouse.
• Jira integration: Suggestions within the add-worktree flow are fetched via the Atlassian CLI (acli), cached locally, and converted into branch-friendly slugs.

Getting Started

cargo install --path .            # install locally
wtm init /path/to/repository      # bootstrap .wtm scaffold
wtm worktree add feature/foo      # create a new worktree
wtm                               # launch the dashboard
wtm gui                           # launch the experimental desktop GUI

The TUI expects the Atlassian CLI (acli) to be installed and authenticated when fetching Jira issues.

GUI Frontend (Experimental)

The GUI provides a mouse-friendly interface backed by the same Git helpers as the TUI:

• Lists existing worktrees with branch/head status.
• Opens PTY-backed terminal tabs per worktree (multiple tabs supported, including scrollback and keyboard input).
• Adds worktrees for new branches (mirrors wtm worktree add).
• Removes worktrees with an opt-in force toggle.
• Launches configured quick actions inside the repository root.

Run wtm gui inside a repository that already has .wtm initialised. The GUI is implemented with egui/eframe; GPU drivers that satisfy wgpu are required.

Workspace Layout

wtm init generates the following structure inside the target repository:

.wtm/
  config.json        # quick actions + misc configuration
  terminals.json     # persisted state for embedded terminals
  workspaces/        # worktree directories managed by WTM (created as needed)

Because the .wtm directory holds environment-specific artefacts, it is excluded from version control by default.

Architecture Overview

The codebase is organised around small, focused modules:

Each module includes unit tests covering parsing and state transitions. To check overall coverage run:

cargo llvm-cov --summary-only

More detail can be found in docs/ARCHITECTURE.md and future ideas live in docs/ROADMAP.md.

Development

cargo fmt        # format
cargo test       # run unit + integration tests

The project targets stable Rust. Some commands (e.g. coverage) install additional toolchain components automatically when needed.

Contributing

1. Fork and clone the repository.
2. Create a feature branch and make your changes.
3. Ensure cargo fmt, cargo test, and cargo llvm-cov --summary-only run cleanly.
4. Submit a pull request outlining the motivation and testing performed.

Licence

This project is released under the MIT licence. See Cargo.toml for details.