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.
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,pushand 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
.wstemplatefiles stamp it, and any sibling project’s, intoCargo.toml,package.jsonand 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 serveopens every board, project and worktree on the host in the browser. - Everyday tools.
refactorreplaces strings across a tree,scrapandunscrapkeep a local trash can, andldiffshows 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
- Documentation Every guide, from the first commands to the daemon.
- Installation The release archives, building from source, and what each program is.
- Getting started A first session with the tools.
- Command reference Every command and its options.
-
Versions and templates
How versions are counted and stamped with
.wstemplatefiles.
Source and licence
- Source
- jowharshamshiri/wsb
- Licence
- Apache License 2.0
- Releases
- releases.bahramj.com/wsb/manifest