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:

Development

  • just local-all – Runs server + assets in parallel with auto-port (recommended for local dev)
  • just local-all-with-worker – Same as above but includes background worker (requires Redis)
  • just local-dev – Runs server only (use with bun dev in separate terminal)
  • just worker-dev – Runs background worker only
  • just update-scaffolding – Updates project to latest template

Parallel Development

Work on multiple features simultaneously using isolated worktrees:

  • just feature-new NAME – Create isolated worktree with new branch from main
  • just feature-list – List all active feature worktrees
  • just feature-done [NAME] – Remove worktree and delete merged branch
  • just feature-drop [NAME] – Force remove worktree and delete branch (even if unmerged)
  • just feature-rebase – Rebase current branch on origin/main

The NAME parameter for feature-done and feature-drop is optional. If omitted, the command auto-detects the current worktree. You can also pass a directory path instead of a branch name.

Use just --list inside a generated project to see all available commands.