Feature

Knows what's stale before work starts

bowline status flags stale bases, missing env, and degraded sync before an agent spends an hour working on the wrong tree.

bowline status flags stale bases, missing env, and degraded sync before work starts. It is a per-project view across your ~/Code: which projects are synced, which are a few commits behind, and which are working from a base that has gone stale.

The point is to catch the expensive mistakes early. A stale base is how an agent burns an hour editing the wrong tree; missing env is how pnpm dev fails three commands in. Surfacing both up front turns a wasted run into a one-line warning you see before you start.

It runs underneath the folder rather than in a dashboard you have to remember to visit. On macOS the menu-bar app shows the same status ambiently, so the health of your workspace is glanceable without opening anything or context-switching out of your terminal.

Because status understands the workspace (source, env, and sync together), it can tell you the difference between 'behind but fine to run' and 'do not hand this to an agent yet.' That is the signal you actually want before a run, not after it.

$ bowline status
acme/webenv synced
acme/api3 commits behind
agent-authbase stale

Questions about status

The questions developers ask about this before they turn it on.

What does bowline status tell me?

A per-project view across your ~/Code: which projects are synced, which are commits behind, which have a stale base, and where env is missing or sync is degraded, all before work starts.

Do I have to check a dashboard?

No. Status runs underneath the folder. Run bowline status from the terminal, or glance at the macOS menu-bar app, which surfaces the same health ambiently without a dashboard to visit.

Why does a stale base matter for agents?

An agent working from a stale base can spend an entire run editing the wrong tree. Flagging the stale base first turns a wasted hour into a one-line warning you see before you hand over the work.

ready when you are

Your ~/Code, on every machine and every agent.

Install bowline and your projects follow you. It just works.

Get started
curl -fsSL https://install.bowline.sh | sh

macOS app · Linux CLI. Then run bowline login.