workspace

Multi-repo worktree first development for humans and agents.

workspace gives your multi-repo setup a single control plane. Git worktrees become lightweight capsules you can lift, dock, and debrief — while your IDE stays in sync automatically.

Get started

Point ws init at a config repo containing your ws.toml and everything gets cloned and wired up:

ws init git@github.com:your-org/workspace-config.git

How it works

Define your repos once in ws.toml:

[workspace]
org = "your-org"
default_branch = "main"

[repos.frontend]
display_name = "Frontend"
aliases = ["fe"]

[repos.backend]
display_name = "API"
after_create = "make setup"

Then use capsules (worktrees) to work on branches without ever switching:

ws lift frontend my-feature    # create a new capsule
ws dock frontend 1234          # check out a PR by number
ws jump fe                     # fuzzy-navigate between capsules
ws debrief                     # clean up anything that's landed

Commands

Install

go install github.com/brudil/workspace/cmd/workspace@latest

Then add to your ~/.zshrc:

eval "$(workspace shell-init zsh)"

This gives you the ws wrapper with shell completions and cd integration.

License

MIT