Skip to main content
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
FlagDescription
-p, --port <number>Port to run on. Defaults to 3000, or the next free port if it’s taken.
--tunnelOpen an Alpic tunnel for remote testing and Playground access.
--no-openDon’t open DevTools when the server is ready.
-v, --verboseShow tunnel logs.
--plainDisable 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/
FlagDescription
-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:
ScriptCommandDescription
devskybridge devStart the development server.
dev:tunnelskybridge dev --tunnelStart the dev server behind an Alpic tunnel.
buildskybridge buildBuild for production.
startskybridge startServe the production build.
deployalpic deployDeploy 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