limb 0.1.0

A focused CLI for git worktree management
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.1.0](https://github.com/ss0923/limb/releases/tag/v0.1.0) - 2026-04-24

Initial release.

### Added

- Nineteen subcommands wrapping `git worktree`: `add`, `cd`, `clean`,
  `completions`, `config`, `doctor`, `init`, `list`, `lock`, `migrate`,
  `pick`, `prune`, `remove`, `rename`, `repair`, `setup`, `status`,
  `unlock`, `update`.
- Interactive TUI picker (`limb pick`) built on [ratatui](https://ratatui.rs)
  with 3-pane layout, `/`-filter backed by
  [nucleo_matcher](https://crates.io/crates/nucleo-matcher), worktree
  preview pane, and six themes (`vesper`, `default`, `nord`, `gruvbox`,
  `solarized`, `plain`). `vesper` is the built-in default, a port of
  [Rauno Freiberg's Vesper](https://github.com/raunofreiberg/vesper).
- Cross-repo mode: `--all` on `list` / `status` / `pick` scans every
  repository under the configured `projects.roots`.
- Per-repo configuration via `.limb.toml`: shared files, templates with
  `{slug}`-pattern interpolation, and four hook points (`pre_add`,
  `post_add`, `pre_remove`, `post_remove`).
- Global configuration at `~/.config/limb/config.toml` (theme, shell
  prefix, default base branch and remote).
- Shell integration (`limb init zsh | bash | fish | pwsh`): wrapper
  functions plus a `precmd` / prompt hook that consumes `limb mark-cd`
  markers so editor-driven worktree switches propagate to the parent
  shell on exit (tmux only).
- `limb add` power flags matching
  [git-worktree(1)](https://git-scm.com/docs/git-worktree): `--detach`,
  `--orphan`, `--lock [--reason]`.
- `--json` output on every mutating command.
- Fuzzy "did you mean?" suggestions for mistyped worktree names
  (Jaro-Winkler via [`strsim`](https://crates.io/crates/strsim)).
- Companion editor plugins:
  [limb.nvim](https://github.com/ss0923/limb.nvim) and
  [limb.tmux](https://github.com/ss0923/limb.tmux).