Skip to content

CLI Reference

Command-line entry points provided by the vibetuner package.

vibetuner scaffold

new

vibetuner scaffold new DESTINATION [options]

Creates a project from the local Vibetuner Copier template.

Options

  • --template, -t – Use a different template source (local path, git URL, github:user/repo, etc.).
  • --defaults, -d – Accept default answers for every prompt (non-interactive).
  • --data key=value – Override individual template variables. Repeat for multiple overrides.
  • DESTINATION must not already exist.

Examples

# Interactive run
vibetuner scaffold new my-project
# Non-interactive defaults
vibetuner scaffold new my-project --defaults
# Override selected values in non-interactive mode
vibetuner scaffold new my-project \
--defaults \
--data project_name="My Project" \
--data python_version="3.12"

See the Scaffolding Reference for a complete description of template prompts and post-generation tasks.

update

vibetuner scaffold update [PATH] [options]

Brings an existing project up to date with the current template.

  • PATH defaults to the current directory.
  • --skip-answered / --no-skip-answered controls whether previously answered prompts are re-asked (defaults to skipping).
  • Exits with an error if .copier-answers.yml is missing.

vibetuner run

Starts framework services without Docker.

dev

vibetuner run dev [frontend|worker] [--port PORT] [--host HOST] [--workers COUNT]
  • Sets DEBUG=1 and enables hot reload.
  • service defaults to frontend.
  • Frontend watches src/app/ and templates/ for changes.
  • Worker runs the Streaq worker with reload enabled (ignores --workers > 1).

prod

vibetuner run prod [frontend|worker] [--port PORT] [--host HOST] [--workers COUNT]
  • Sets ENVIRONMENT=production.
  • Disables hot reload and honors --workers for both frontend and worker services.
  • Useful for containerless deployments or reproducing production settings locally.

vibetuner db

Database management commands for SQL databases (SQLModel/SQLAlchemy).

create-schema

vibetuner db create-schema

Creates all database tables defined in SQLModel metadata. This command:

  1. Imports models from app.models to ensure they're registered
  2. Creates tables in the database specified by DATABASE_URL
  3. Skips if tables already exist (safe to run multiple times)

Prerequisites:

  • DATABASE_URL environment variable must be set
  • Models must be defined using SQLModel with table=True

Example:

# Set database URL
export DATABASE_URL=postgresql+asyncpg://user:pass@localhost/mydb

# Create tables
vibetuner db create-schema

Note: This command is only for SQL databases. MongoDB collections are created automatically when documents are inserted.

Generated projects expose additional helpers in the scaffolded justfile, including just local-dev, just worker-dev, and just update-scaffolding, which wrap the commands above. Use just --list inside a generated project to see everything available.