Skip to content

Command Reference

All pascal commands follow the pattern pascal <command> [args] [flags].

Run pascal --help or pascal <command> --help for built-in help text.

Overview

Command Description
pascal init Bootstrap a new workspace
pascal create package Scaffold a new reusable library
pascal create app Scaffold a new deployable app
pascal add Wire a package into an app
pascal info Print workspace overview
pascal deps Show the dependency tree
pascal check Validate workspace health
pascal diff Show changed packages since a git ref
pascal test Run tests via UV
pascal build Build an app wheel
pascal run Run an app entry-point
pascal sync Regenerate UV workspace config

Global behaviour

  • Workspace detection: every command (except init) walks up from the current directory to find pascal.toml. You can run commands from any subdirectory.
  • Exit codes: 0 on success, 1 on error. pascal check exits 1 if errors (not warnings) are found.
  • Colour: output is coloured by default. Pipe to a file or set NO_COLOR=1 to disable.