Command line and workbench

wsb

wsb is one command for working across a repository and every submodule under it: git over the whole fleet, versions counted and stamped into every manifest, worktrees and Claude Code sessions, GitHub mirrored per workshop, and a workbench in the browser served by its daemon.

No release yet

What it is

wsb is three programs installed side by side. wsb is the command line, and every tool is a subcommand of it. wsb-daemon is the process that stays: it serves the workbench, keeps the workshop’s GitHub mirror current, and carries work between paired workshops. wsb-claude is the Claude bridge, through which one Claude Code session sees and directs the sessions of every paired workshop. wsb starts the daemon from its own directory, so the three are installed and upgraded together.

  • Git across a fleet. wsb status, stage, commit, push and the rest work on the current repository or on a root and every submodule under it.
  • Versions counted and stamped. A version is counted from the commits of the repository and its submodules, and .wstemplate files stamp it, and any sibling project’s, into Cargo.toml, package.json and every other manifest.
  • Worktrees and sessions. A project’s worktrees, submodules and all, are made, archived, packed and moved between machines, each with its Claude Code sessions.
  • GitHub from one mirror. Issues, pull requests, CI and every Projects board of your account and organisations, mirrored once per workshop.
  • The workbench. wsb serve opens every board, project and worktree on the host in the browser.
  • Everyday tools. refactor replaces strings across a tree, scrap and unscrap keep a local trash can, and ldiff shows how lines differ as they stream past.

A released wsb knows the registry it was published in and the keys its releases are signed with: wsb upgrade installs the next release of its channel after checking its signatures and its archive. A wsb installed by apt, dnf or Homebrew leaves upgrades to that package manager.

Install

No release of wsb is published yet. It is built from its source.

  • Building from source

    wsb, wsb-daemon and wsb-claude built and installed with QuickRust.

    The build instructions

Documentation

Source and licence