workbench-ai 0.1.0

Universal AI session continuity protocol and CLI

workbench-ai

Universal AI session continuity protocol and CLI.

Install

pip install workbench-ai

Commands

workbench init

Initialize workbench state files in the current project. Auto-detects project type, generates STATE_VECTOR.json and HANDOFF.md, and creates a .workbench config file.

cd my-project
workbench init

Options:

• -p, --project — Project slug (default: directory name)
• -t, --type — Project type override
• --bridge — Bridge repo (e.g. yourname/workbench)

workbench sync

Sync state files to your workbench bridge repo.

workbench sync

Options:

• --bridge — Bridge repo override
• --dry-run — Preview without pushing

workbench status

Show status of all projects in the bridge repo.

workbench status --bridge yourname/workbench

Options:

• --bridge — Bridge repo
• --json — Output as JSON

workbench bootstrap

Generate a paste-ready bootstrap prompt for any AI chat.

workbench bootstrap -p my-project --clipboard

Options:

• -p, --project — Project slug (required)
• --bridge — Bridge repo override
• --clipboard — Copy to clipboard

How It Works

1. workbench init creates structured state files in your project
2. workbench sync pushes them to a central bridge repo on GitHub
3. workbench bootstrap generates a prompt you paste into any AI chat
4. The AI reads your state files and has full context in under 60 seconds

Requirements

• Python 3.10+
• git

License

MIT