ws

Parallel AI coding agents in isolated git worktrees.

Install

curl -fsSL https://raw.githubusercontent.com/workstream-labs/workstreams/main/install.sh | bash

Or from source (requires Bun):

git clone https://github.com/workstream-labs/workstreams.git
cd workstreams
bun install && bun link

Quick Start

ws init                                        # set up in any git repo
ws create add-tests -p "Add unit tests"        # define tasks
ws create dark-mode -p "Implement dark mode"
ws run                                         # run all in parallel
ws dashboard                                   # review diffs, leave comments, resume

Each workstream runs in its own git worktree on a ws/ branch. When you're happy with the result, merge the branch and clean up with ws destroy.

See the docs for configuration, commands, and guides.

Contributing

See CONTRIBUTING.md.

License

MIT

---

If this is useful to you, a star helps others find it.