Common troubleshooting

Workspace is not found

Run commands inside the intended workspace. Initialize it explicitly if .sqlrs/ does not exist:

sqlrs init

The CLI refuses accidental nested workspaces unless the user explicitly overrides that guard.

Container runtime is unavailable

Confirm the release-supported runtime for your platform is installed and running. Runtime selection and snapshot capabilities differ across Linux, Windows/WSL2, and macOS; do not copy a Btrfs instruction to macOS.

A psql file is rejected

File inputs must resolve under the workspace root. Paths in raw commands are current-working-directory relative; paths stored inside aliases are alias-file relative.

An alias is not found

Alias references are exact, current-working-directory-relative logical stems. The CLI does not scan the whole repository and guess a basename. Inspect the current scope:

sqlrs alias ls
sqlrs alias check