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.