One-shot mode

One-shot mode lets you describe what you want to build at a high level — like "Build a complete billing system with invoices and payment tracking" — and Lasso will plan, execute, and validate the changes automatically.

How it works

Press ⌘K anywhere in your app to open the command bar. Describe what you want to build, and Lasso will:

1. Understand: Analyze your project structure, framework, and dependencies
2. Plan: Generate execution steps (install packages, create files, modify components)
3. Execute: Run each step with real-time progress visibility
4. Validate: Run typecheck and build to verify the changes

Progress visibility

While Lasso works, you'll see updates like:

✓ Analyzed project
✓ Found Next.js + TypeScript
✓ Created auth configuration
✓ Added login page
✓ Added signup page
● Running typecheck...
✓ Typecheck passed
✓ Build passed

The review tray updates as files change, so you can inspect the agent's progress while it works. Accept to keep the resulting edits, or reject to restore the pre-task files.

Scope management

One-shot mode supports two scopes:

• Project scope: Broad changes across the entire codebase (default for ⌘K)
• Component scope: Targeted changes to a specific component (for visual selection)

This prevents a simple "Make this button bigger" from causing the agent to wander through 40 unrelated files.

Console and runtime errors in context

One-shot requests carry the live console state of the page, not just the DOM. The overlay captures uncaught errors, unhandled promise rejections, and anything your app logs through console.error — starting from page load, so a broken import or a missing named export is recorded even if it happened before your first prompt.

• The latest five unique errors travel with the request as pageContext.runtimeErrors.
• The buffer clears when you apply a change, so the next prompt only shows problems introduced by the new code.
• The agent treats listed errors as part of the task and verifies package export names before importing them.

Combine with visual editing

The real power comes from combining one-shot and visual modes:

1. Use ⌘K to generate a large feature (e.g., "Build a dashboard for managing customers")
2. Use visual selection to refine specific parts (e.g., "Make this table denser and add bulk actions")
3. Use ⌘K again to add another large feature
4. Use visual selection to polish the details

Creating new projects

You can also use one-shot mode when creating a new project:

lasso create my-app
# After scaffold creation:
? Do you want to describe your app for Lasso to build initial features?
✓ Yes, describe my app
? Describe what you're building:
  A SaaS dashboard for managing customer invoices

Lasso will then create the project scaffold and immediately start building the initial application based on your description.

Next steps

Learn about all CLI commands or return to the quickstart.