wbcli 0.0.1__tar.gz

wbcli-0.0.1/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @duncankmckinnon

wbcli-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history for setuptools-scm
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests with coverage
+        run: pytest tests/ -v

wbcli-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,110 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history for setuptools-scm
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: "pypi"
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          # Get previous tag
+          PREV_TAG=$(git tag --sort=-v:refname | head -2 | tail -1)
+          if [ -z "$PREV_TAG" ]; then
+            CHANGELOG=$(git log --oneline --no-decorate)
+          else
+            CHANGELOG=$(git log --oneline --no-decorate ${PREV_TAG}..HEAD)
+          fi
+          echo "changelog<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGELOG" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body: |
+            ## Changes
+
+            ${{ steps.changelog.outputs.changelog }}
+
+            ## Install
+
+            ```bash
+            pip install wbcli
+            ```
+          files: dist/*
+          generate_release_notes: false

wbcli-0.0.1/.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+*.egg
+workbench/_version.py
+.coverage
+
+# Virtual environments
+.venv/
+
+# Workbench runtime
+.workbench/
+
+# OS
+.DS_Store
+
+# IDE
+.idea/
+.vscode/
+*.swp

wbcli-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Duncan McKinnon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wbcli-0.0.1/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: wbcli
+Version: 0.0.1
+Summary: Lightweight multi-agent orchestrator for iterative development
+Author: Duncan McKinnon
+License-Expression: MIT
+Project-URL: Repository, https://github.com/duncankmckinnon/workbench
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-mock>=3.12; extra == "dev"
+Requires-Dist: pytest-cov>=6.0; extra == "dev"
+Dynamic: license-file

wbcli-0.0.1/README.md

@@ -0,0 +1,208 @@
+# Workbench
+
+[![CI](https://github.com/duncankmckinnon/workbench/actions/workflows/ci.yml/badge.svg)](https://github.com/duncankmckinnon/workbench/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/wbcli)](https://pypi.org/project/wbcli/)
+[![Python](https://img.shields.io/pypi/pyversions/wbcli)](https://pypi.org/project/wbcli/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Multi-agent orchestrator that dispatches AI coding agents in parallel across isolated git worktrees.
+
+Write a markdown plan, run `wb run plan.md`, and workbench parses it into tasks, groups them into dependency waves, and runs each task through an implement → test → review → fix pipeline.
+
+## Requirements
+
+- Python 3.11+
+- tmux (recommended — `brew install tmux` / `apt install tmux`). Use `--no-tmux` without it.
+- An agent CLI: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (default), [Codex](https://github.com/openai/codex), or any custom CLI.
+
+## Install
+
+```bash
+pip install wbcli
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"   # includes pytest
+```
+
+## Usage
+
+```bash
+wb setup                          # create .workbench/ and install skills
+wb preview plan.md                # dry-run: show tasks and waves
+wb run plan.md                    # run the plan
+wb run plan.md -j 6 --no-tmux    # 6 parallel agents, no tmux
+wb run plan.md --agent codex      # use codex instead of claude
+wb status                         # show active worktrees
+wb clean                          # remove all worktrees and wb/ branches
+```
+
+### Resuming a run
+
+```bash
+wb run plan.md -b workbench-2 -w 3   # resume session branch from wave 3
+```
+
+### Directive overrides
+
+Override the instructions given to any agent role:
+
+```bash
+wb run plan.md --reviewer-directive "Focus only on security issues."
+wb run plan.md --tester-directive "Run pytest with -x flag, fail fast."
+```
+
+Available: `--implementor-directive`, `--tester-directive`, `--reviewer-directive`, `--fixer-directive`.
+
+## Plan format
+
+## TDD mode
+
+Run with `--tdd` to write tests before implementation:
+
+```bash
+wb run plan.md --tdd
+```
+
+Pipeline becomes: **write tests → implement → verify tests → review → fix**
+
+The tester agent writes comprehensive failing tests based on the task description, then the implementor writes code to make them pass. After that, normal test verification and review proceed as usual.
+
+Cannot be combined with `--skip-test`.
+
+## Stopping agents
+
+```bash
+wb stop              # kill all active agent tmux sessions
+wb stop --cleanup    # also remove worktrees and branches
+```
+
+## CLI reference
+
+| Command | Description |
+|---|---|
+| `wb run <plan>` | Execute a plan |
+| `wb preview <plan>` | Dry-run preview of tasks and waves |
+| `wb status` | Show active worktrees |
+| `wb stop` | Stop all running agents and optionally clean up |
+| `wb clean` | Remove all workbench worktrees and branches |
+| `wb init` | Set up workbench for your agent platform |
+
+## Conventions
+- Python 3.11+, type hints
+- Tests: pytest, run with `uv run pytest`
+
+| Flag | Description |
+|---|---|
+| `-j N` | Max concurrent tasks (default: 4) |
+| `--tdd` | Test-driven: write tests first, then implement |
+| `--skip-test` | Skip the test phase |
+| `--skip-review` | Skip the review phase |
+| `--max-retries N` | Max fix cycles per task (default: 2) |
+| `--agent CMD` | Agent CLI command (default: `claude`) |
+| `--no-tmux` | Run agents as subprocesses instead of in tmux sessions |
+| `--session-branch NAME` | Resume an existing session branch |
+| `--start-wave N` | Skip already-merged waves |
+| `--cleanup` | Remove worktrees after completion |
+| `--repo PATH` | Repository path (auto-detected if omitted) |
+
+- `## Context` and `## Conventions` are injected into every agent's prompt.
+- `Files:` declares which files the task owns (prevents parallel conflicts).
+- `Depends:` references other tasks by slug (title lowercased, non-alphanumeric → `-`).
+- Tasks without dependencies run in the earliest wave. Keep titles short (2-4 words) — they become dependency slugs.
+
+## Agent pipeline
+
+Each task runs through:
+
+```
+implement → test → review → fix (retry up to --max-retries)
+```
+
+Skip stages with `--skip-test` or `--skip-review`. Merge conflicts between parallel branches are automatically resolved by a merger agent.
+
+## Custom agents
+
+Define adapters in `.workbench/agents.yaml`:
+
+```yaml
+agents:
+  my-agent:
+    command: my-agent-cli
+    args: ["--headless", "{prompt}"]
+    output_format: json
+    json_result_key: result
+    json_cost_key: cost_usd
+```
+
+```bash
+wb run plan.md --agent my-agent
+```
+
+## Agent commands
+
+Workbench bundles guidance files that teach agents how to write plans. `wb init` installs them in the right format for each platform:
+
+```bash
+wb init --agent claude     # installs as /use-workbench command in ~/.claude/commands/
+wb init --agent cursor     # installs as rule in .cursor/rules/
+wb init --agent codex      # appends to .codex/instructions.md
+wb init --agent manual     # prints paths for manual setup
+wb init --symlink          # symlink instead of copy (for development)
+```
+
+`wb setup` combines `.workbench/` creation with command installation in one step.
+
+## Monitoring
+
+With tmux (default), attach to watch an agent work:
+
+```bash
+tmux attach -t wb-task-1-implementor
+```
+
+Sessions are named `wb-task-<N>-<role>`.
+
+## CLI reference
+
+| Command | Description |
+|---|---|
+| `wb run <plan>` | Execute a plan |
+| `wb preview <plan>` | Show tasks and waves |
+| `wb status` | Show active worktrees |
+| `wb clean` | Remove worktrees and branches |
+| `wb init` | Install skills for an agent platform |
+| `wb setup` | Create `.workbench/` and install skills |
+
+| `wb run` flag | Description |
+|---|---|
+| `-j N` | Max concurrent agents (default: 4) |
+| `-r N` | Max fix retries per stage (default: 2) |
+| `--skip-test` | Skip testing phase |
+| `--skip-review` | Skip review phase |
+| `--agent CMD` | Agent CLI (default: `claude`) |
+| `--no-tmux` | Raw subprocess instead of tmux |
+| `-b NAME` | Resume a session branch |
+| `-w N` | Start from wave N |
+| `--cleanup` | Remove worktrees after completion |
+| `--*-directive` | Override role instructions |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # 114 tests
+```
+
+Version is derived from git tags via `setuptools-scm`. Published to PyPI as [`wbcli`](https://pypi.org/project/wbcli/). To release:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0    # triggers CI → PyPI + GitHub Release
+```
+
+## License
+
+MIT

wbcli-0.0.1/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=68.0", "setuptools-scm>=8.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wbcli"
+dynamic = ["version"]
+description = "Lightweight multi-agent orchestrator for iterative development"
+license = "MIT"
+authors = [{name = "Duncan McKinnon"}]
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "click>=8.0",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-mock>=3.12",
+    "pytest-cov>=6.0",
+]
+
+[project.urls]
+Repository = "https://github.com/duncankmckinnon/workbench"
+
+[project.scripts]
+wb = "workbench.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+
+[tool.setuptools.package-data]
+"workbench.skills" = ["**/*.md"]
+
+[tool.setuptools_scm]
+write_to = "workbench/_version.py"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+addopts = "--cov=workbench --cov-report=term-missing --cov-fail-under=70"
+
+[tool.coverage.run]
+omit = [
+    "workbench/_version.py",
+    "workbench/skills/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.",
+    "if TYPE_CHECKING:",
+]

wbcli-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wbcli-0.0.1/tests/conftest.py

@@ -0,0 +1,35 @@
+"""Shared test fixtures."""
+
+import subprocess
+
+import pytest
+
+
+@pytest.fixture
+def git_repo(tmp_path):
+    """Create a temporary git repo with main branch and initial commit."""
+    subprocess.run(
+        ["git", "init", "--initial-branch=main"],
+        cwd=tmp_path,
+        check=True,
+        capture_output=True,
+    )
+    subprocess.run(
+        ["git", "config", "user.email", "test@test.com"],
+        cwd=tmp_path,
+        capture_output=True,
+    )
+    subprocess.run(
+        ["git", "config", "user.name", "Test"],
+        cwd=tmp_path,
+        capture_output=True,
+    )
+    (tmp_path / "README.md").write_text("init")
+    subprocess.run(["git", "add", "."], cwd=tmp_path, capture_output=True)
+    subprocess.run(
+        ["git", "commit", "-m", "init"],
+        cwd=tmp_path,
+        check=True,
+        capture_output=True,
+    )
+    return tmp_path