Components
The parts of Coxswain. Four are folders of the one repository, ppfenning/coxswain, and ship in every release. Dash is its own repository and is optional.
| Name | Where | Installed | What it does |
|---|---|---|---|
| Tools | src/tools |
always, provides cox |
The cox CLI: install, dispatch, run the loop, land. |
| Graphs | src/graphs |
always | The graphs a run executes, and the harness that runs them. |
| Cartridges | src/cartridges |
always | A team's or repo's context: roles, skills, policy, providers. |
| Crew | crew |
always, linked into ~/.claude/agents |
The agent seats that plan, build, review, and validate. |
| Dash | ppfenning/coxswain-dash | --with dash, provides towpath |
A terminal dashboard for the fleet. |
The four folders are one checkout at one release tag, with one venv, so they
always match. manifest.toml names only dash, at the tag a release pins it to.
Each folder runs its own tests from inside it:
cd src/tools && uv run pytest -q
The same works for src/graphs and src/cartridges. The root suite runs from
the repository root with uv run pytest -q.