arborista

arborista is a Bun/TypeScript CLI for elegant git worktree oversight.

Install

arborista is published on npm, but it runs on Bun.

npm install -g arborista

If Bun is not already installed, install it first from https://bun.sh.

Git Hooks

This project uses hk for git hook management. The configuration is in hk.pkl.

To install the hooks in your local clone:

hk install

The configured hooks run bun run check on pre-commit and pre-push.

Config

Config lives at ~/.config/arborista/arborista.jsonc.

Example:

{
	"root": "~/Dev/.arborista",
}

Only root is used in v1. Commands always act on repo found from current working directory.

Commands

arborista list [--dir]
arborista ls [--dir]
arborista new <branch> [--from <start-point>]
arborista dir <branch>
arborista rm <branch> [--branch]
arborista move

Comparison to Git

For a 1:1 mapping from each arb command to the exact underlying Git commands, see docs/comparison-to-git.md.