Files
rdbms-playground/website/src/content/docs/using-the-playground/command-line-options.md
T
claude@clouddev1 fb536b4245
ci / gate (push) Successful in 1m55s
ci / manifests (push) Successful in 3s
website / deploy (push) Successful in 35s
docs(website): reconcile installation docs with v0.2.0 shipped reality
installation.md predated the install/packaging work that landed on main:
- drop the "once published" placeholders now that v0.2.0 is live
- fix the Homebrew/Scoop commands (tap/bucket-add forms; the bare
  `brew install rdbms-playground` was wrong)
- add the curl|sh and PowerShell one-line installers (ADR-0055),
  `cargo install` / `cargo binstall` (ADR-0056), and prebuilt binaries
- present winget as coming-soon (PR awaiting the public catalogue)

command-line-options.md: add `-V`/`--version` and the in-app `version`
command (ADR-0054).
2026-06-21 22:21:26 +00:00

2.0 KiB

title, description, sidebar
title description sidebar
Command-line options How to start the playground, open a project, and the flags you can pass.
order
1

Start the playground with no arguments and it opens a fresh, automatically named temporary project so you can begin straight away:

rdbms-playground

To open an existing project, give its path:

rdbms-playground path/to/project

Options

Option Effect
--resume Reopen the most recently used project. Errors if there is none; cannot be combined with a project path.
--data-dir <PATH> Use PATH as the data root instead of the OS-standard location for this run.
--mode <simple|advanced> Start in this input mode, overriding the project's stored mode (precedence: --mode > stored > simple).
--theme <light|dark> Force a theme instead of auto-detecting from the terminal.
--no-undo Disable the undo machinery for this run — no snapshot is taken before each change (see Undo, redo & history).
--demo Turn on demonstration mode — a teaching aid that briefly shows an on-screen badge for keys that otherwise leave no visible mark (Tab, Enter, the arrows, and the like). Useful for screencasts and for demonstrating the playground to a class. Off by default.
--log-file <PATH> Write diagnostic logging to PATH.
-V, --version Print the version and exit.
-h, --help Print the usage banner and exit.

Once the playground is running, the version command prints the same version line into the output panel — handy when you want to note which version you're on without leaving the app.

Examples

# Reopen wherever you left off, in advanced mode
rdbms-playground --resume --mode advanced

# Keep a course's projects in one folder
rdbms-playground --data-dir ~/db-course

Where projects are stored, and what a project contains, is covered in Projects and storage.