CLI reference

The Lasso CLI starts the local bridge, manages project registration, and provides the local host for stable domains.

Development

lasso dev
# or
npx @lasso-ai/cli dev

Starts a detected Vite, Next.js, or Nuxt project with the overlay attached.

Project creation

lasso create [name]
lasso create [name] --prompt "Describe your app"

Creates a brand-new Lasso project with framework scaffolding. Supports Next.js, React, Vue, Svelte, and Solid with TypeScript and package manager selection.

Authentication

lasso auth login
lasso auth status
lasso auth logout

Project setup

lasso init
lasso register [domain]
lasso projects

init creates project configuration and registers a local domain.

Diagnostics

lasso doctor

Diagnoses configuration and integration problems. Checks for lasso.config.json, API key configuration, framework detection, and package.json presence.

Lasso Host

lasso daemon start
lasso daemon status
lasso daemon restart
lasso daemon stop

Defaults are HTTP on 6766 and HTTPS on 6767. Override them with LASSO_HOST_PORT and LASSO_HOST_HTTPS_PORT.

Coding agents

You choose the agent in the overlay model picker, not in a config file. A local CLI agent appears as its own group only when its binary is on the PATH that lasso dev sees.

• Claude Code — requires claude on PATH and a completed sign-in.
• Codex — requires codex on PATH and a completed sign-in.
• Cursor Agent — requires cursor-agent on PATH and a completed sign-in.
• OpenCode — requires opencode on PATH, an authenticated provider, and a writable state folder.
• Antigravity — requires agy on PATH and a completed sign-in.

For a hosted agent, set the provider and key in your environment or in the project .env before starting lasso dev:

LASSO_AGENT_PROVIDER=anthropic   # or openai, google, ollama
ANTHROPIC_API_KEY=...
LASSO_AGENT_MODEL=...        # optional

Supported keys are ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY (or GEMINI_API_KEY), and OLLAMA_BASE_URL with OLLAMA_MODEL. Hosted agents additionally require your Lasso key from lasso auth login.

Next steps

Read the host guide for secure local domains.