terris

A small, friendly Git worktree manager for everyday use.

What it does

• Create new worktrees quickly (or jump to existing ones)
• List existing worktrees
• Remove worktrees safely
• Print a worktree path for cd "$(terris <branch>)"
• Simplify workflows with autonomous agents that work in the terminal in the same repository

Install

From crates.io (once published):

cargo install terris

From source:

cargo install --path .

Update:

cargo install --path . --force

Usage

terris <branch>
terris --list
terris --delete <branch>

How it works

• terris <branch> creates the worktree if missing and prints the path every time.
• If the branch exists, it is used directly.
• If the branch does not exist, it is created from the current HEAD.
• Default path is ~/.terris-worktrees/<repo-name>/<branch>-<8-random-lowercase-letters>.

Examples

# Create or open a worktree (branch "feature-a")
terris feature-a

# List worktrees
terris --list

# Jump to a worktree
cd "$(terris feature-a)"

# Delete a worktree
terris --delete feature-a

Notes

• Works from any directory inside a git repo.
• The tool shells out to git, so git must be installed and available in PATH.

Name

The project is named after the Terris people, responsible for preserving the knowledge of the civilization.

License

MIT