CLI

Skybridge ships one CLI, available as both skybridge and sb once it’s installed in your project. It’s a project dependency, not a global install, so run it through your package manager, or the package scripts a scaffold sets up.

`create`

Scaffold a new project. Run it before the package is installed with npx:

npx skybridge create

See Quickstart to scaffold and run a project.

`dev`

Start the development server with hot module reloading and DevTools.

npx skybridge dev

pnpm skybridge dev

yarn skybridge dev

bun skybridge dev

deno run -A npm:skybridge/skybridge dev

Serves the MCP endpoint at http://localhost:3000/mcp
Opens DevTools for local testing at http://localhost:3000/
Watches files and restarts the server, with HMR for views

Flag	Description
`-p, --port <number>`	Port to run on. Defaults to `3000`, or the next free port if it’s taken.
`--tunnel`	Open an Alpic tunnel for remote testing and Playground access.
`--no-open`	Don’t open DevTools when the server is ready.
`-v, --verbose`	Show tunnel logs.
`--plain`	Disable the interactive UI and stream the server’s stdout verbatim, so you can pipe it through a formatter (e.g. `skybridge dev --plain \| bunyan`).

The scaffolded package.json adds a dev:tunnel script, shorthand for skybridge dev --tunnel. The port also reads from the PORT environment variable. Set SKYBRIDGE_OPEN=false in your shell profile to skip opening DevTools on every run, the equivalent of always passing --no-open.

Formatting structured logs

If your server uses a structured JSON logger like bunyan or pino, pass --plain and pipe through the logger’s formatter:

skybridge dev --plain | bunyan
skybridge dev --plain | pino-pretty

`build`

Compile your views and MCP server for production.

npx skybridge build

pnpm skybridge build

yarn skybridge build

bun skybridge build

deno run -A npm:skybridge/skybridge build

The output lands in dist/, ready for the deploy script or skybridge start.

`start`

Run the production server from the build output. Run skybridge build first.

npx skybridge start

pnpm skybridge start

yarn skybridge start

bun skybridge start

deno run -A npm:skybridge/skybridge start

Serves the MCP endpoint at http://localhost:3000/mcp
Runs the compiled server and pre-built view assets from dist/

Flag	Description
`-p, --port <number>`	Port to run on. Defaults to `3000`, or the next free port if it’s taken. Also reads `PORT`.

`telemetry`

The CLI reports anonymous usage, on by default. Toggle it with skybridge telemetry disable, enable, or status. See Telemetry for what’s collected and every way to opt out.

Package scripts

A scaffolded project wires the commands into package.json:

Script	Command	Description
`dev`	`skybridge dev`	Start the development server.
`dev:tunnel`	`skybridge dev --tunnel`	Start the dev server behind an Alpic tunnel.
`build`	`skybridge build`	Build for production.
`start`	`skybridge start`	Serve the production build.
`deploy`	`alpic deploy`	Deploy through the Alpic CLI. See Deploy for per-platform setup.

Run them with your package manager:

npm run dev
npm run build
npm start

pnpm dev
pnpm build
pnpm start

yarn dev
yarn build
yarn start

bun dev
bun build
bun start

deno task dev
deno task build
deno task start

Quickstart

Scaffold and run your first app

Ship

Deploy to your platform of choice

McpServer

The server the CLI builds and runs

Server

Auth

Identity Providers

Hooks

Utilities

Types

Low-level

`create`

`dev`

Formatting structured logs

`build`

`start`

`telemetry`

Package scripts

Quickstart

Ship

McpServer

​create

​dev

​Formatting structured logs

​build

​start

​telemetry

​Package scripts

Quickstart

Ship

McpServer

`create`

`dev`

Formatting structured logs

`build`

`start`

`telemetry`

Package scripts