CLI

Blyp now has a separate CLI project for local developer workflows.

GitHub: Blyphq/cli
npm: @blyp/cli

The CLI package is @blyp/cli, and the executable command is blyp.

If you do not want a global install, use:

bunx @blyp/cli <command>

What it does

The current CLI README describes blyp as the local entrypoint for:

launching Blyp Studio for a target project
printing runtime and workspace diagnostics
installing Blyp skills into a project-local .agents/skills directory
guiding Prisma or Drizzle database logging setup for @blyp/core

Studio

Studio is the local web UI that ships with the Blyp CLI. It runs at http://localhost:3003 and connects to a target project on your machine.

What Studio does

Inspects the target project from your local machine
Connects assistant workflows to a specific project path
Uses project-level AI settings via OPENROUTER_API_KEY and OPENROUTER_MODEL

Launching Studio

Launch for the current directory:

blyp studio

Launch for a specific subdirectory:

blyp studio ./apps/my-app

If Studio is already running, the CLI reuses the existing instance and opens the correct project in the browser.

Commands

`blyp studio [targetPath]`

Starts or reuses the local Studio app for the target project. If targetPath is omitted, the current directory is used.

`blyp health`

Prints runtime details such as the current directory, runtime versions, detected workspace root, and the Studio web app path.

`blyp skills install [source-or-skill-name] [--force]`

Installs a local skill folder, installs a bundled skill by name, or opens the bundled skill picker.

Installed skills are copied into:

./.agents/skills/<skill-name>

`blyp db:init`

Guided Blyp database logging setup.

prompts for adapter: prisma or drizzle
prompts for dialect: postgres or mysql
scaffolds the blyp_logs schema
runs the generated migration workflow
writes blyp.config.ts for the project

`blyp db:migrate`

Runs the configured Prisma or Drizzle migration workflow after the project has been initialized.

`blyp db:generate`

Runs Prisma client generation for configured Prisma projects.

This command is Prisma-only and is not used for Drizzle projects.

`blyp help`

Shows command usage.

`blyp --version`

Prints the CLI version.

Supported database setups

Prisma + Postgres
Prisma + MySQL
Drizzle + Postgres
Drizzle + MySQL

Upgrade note

Upgrade note: Use blyp db:init for guided database setup.

Use the shorter top-level commands instead:

blyp db:init
blyp db:migrate
blyp db:generate

Without a global install:

bunx @blyp/cli db:init
bunx @blyp/cli db:migrate
bunx @blyp/cli db:generate

Notes

The CLI lives in a separate repository from @blyp/core.
The published command name is blyp.
Studio runs locally at http://localhost:3003.

CLI