› tarjan

Quick start

Install tarjan and bring up your first environment.

Install

Download a prebuilt binary from the latest release and put it on your PATH, or build from source:

go install github.com/stevenzg/tarjan@latest   # needs Go 1.25+

Verify with tarjan version.

Your first environment

tarjan init         # writes a starter tarjan.yaml (or `tarjan init --star` for Starlark)
$EDITOR tarjan.yaml # point it at your repos and services
tarjan up           # clone, check tools, generate workspace, start everything

With no version: in the config, each tarjan up materialises a fresh, timestamped workspace under workspaceRoot, so every run starts from a clean slate. Set a top-level version: (or pass --version <label>) to get a named, reusable workspace instead — repeated runs skip the clones and setup steps already done, so it comes back fast. See Workspaces & versions.

Day-to-day

tarjan status --watch          # live readiness of every service
tarjan ui                      # full-screen dashboard
tarjan logs api -f             # follow a service's logs
tarjan restart api             # restart one service in place
tarjan reload                  # reconcile a running env to the edited config
tarjan exec api -- npm test    # run a command in a service's dir + environment
tarjan pull                    # fast-forward every cloned repo in the workspace

On this page