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).
2.0 KiB
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. |
|
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.