@boardwalk-labs/setup

One command to get set up with Boardwalk:

npx @boardwalk-labs/setup

It installs the boardwalk CLI if you don't have it, then runs boardwalk setup, which:

• logs you in (browser OAuth),
• detects which coding agent you use (Claude Code, Codex, Cursor, OpenCode, OpenClaw), and
• installs that agent's Boardwalk plugin + skills and points it at the control-plane MCP server.

It never touches files in your project — it wires up the agent and leaves your repo alone.

Already have the CLI?

Skip the shim and run the wizard directly:

boardwalk setup

What this package is

A tiny, dependency-free launcher. All the real logic lives in the CLI's boardwalk setup command, so there's one tested code path whether you arrive via npx @boardwalk-labs/setup or boardwalk setup. Any arguments you pass are forwarded, e.g.:

npx @boardwalk-labs/setup --harness claude-code --yes   # non-interactive
npx @boardwalk-labs/setup --print-only                  # show the plan, run nothing

Resolution order: run boardwalk if it's on PATH; otherwise npm install -g @boardwalk-labs/cli and run it; otherwise fall back to npx @boardwalk-labs/cli setup.

The Boardwalk repos

• cli — boardwalk: scaffold, validate, run locally, deploy
• plugins — coding-agent skills + the control-plane MCP server
• sdk — @boardwalk-labs/workflow, the API a workflow imports

Hosted platform and docs: boardwalk.sh.

License

MIT — see LICENSE.