WunderCorp bs

WunderCorp bs is the headless BuilderStudio CLI. It exposes the local daemon through the bs command for terminal-based agentic development, approval-aware host operations, external AgentVM interoperability, Stripe Link payments, OpenRouter-powered model routing, runtime repair, MCP, plugins, Git, deployment preflight, and interoperability with Claude Code, OpenCode, Cursor, Codex, and other terminal AI tools.

npm install -g @wundercorp/bs
bs init
bs gain "build the requested feature"
bs operate "prepare this machine or a temporary VM"
npm install -g @wundercorp/agentvm
bs avm help
bs link --help
bs kanban generate "create a release board"
bs workflow generate "create a connected release workflow"
bs repair --command "npm run dev"
bs interop install all
bs telemetry enable

The CLI prints an ASCII WUNDERCORP banner on interactive startup. Package names and human-facing product text use WunderCorp.

OpenRouter quick start

bs init --key sk-or-your-key --model openrouter/auto

After the first setup, bs init reuses the saved OpenRouter profile/key from ~/.wundercorp/bs and will not ask again unless you run bs model setup --replace-key. You can also use environment variables:

OPENROUTER_API_KEY=sk-or-your-key bs init

Common commands

bs ask "explain this repo"
bs gain "add auth"
bs operate "prepare and verify the development environment"
bs avm plan "Create a small Ubuntu server for two hours" --save
bs link auth status
bs kanban show
bs workflow canvas
bs /repair --command "npm run dev"
bs model list
bs workspace tree
bs term npm test
bs mcp list
bs plugin list
bs deploy preflight
bs hook install --global --agent bs
bs interop install all

AgentVM cost boundaries

Operator uses bs avm status and bs avm limits for launch readiness. bs avm billing forwards to the AgentVM billing setup command, so its URL-only response is not treated as a failed readiness result.

Before AgentVM provisioning, Operator verifies the exact image against the live catalog and calculates the authorization cap as the greater of the runtime estimate and the provider minimum billable charge. For Hetzner, the selected plan retail hourly charge is treated as the minimum cost floor unless the catalog explicitly proves a smaller minimum.

IDE and AI tool interoperability

cd path/to/codebase
bs init
bs interop install all

This writes project-local guidance and command files for Claude Code, OpenCode, Cursor, and Codex so those tools know how to call bs from the repository root.

License

Licensed under the Apache License, Version 2.0. See the included LICENSE file.

Public package contents

This npm package ships a compact compressed release loader instead of TypeScript source or readable daemon modules. The embedded runtime payload is generated from compiled JavaScript, lightly minified, gzip-compressed, and extracted into a local WunderCorp release cache at runtime. It excludes TypeScript source, source maps, tests, and internal implementation docs.