run command is the primary command used to execute tasks and targets defined in your workspace.
Arguments
The command accepts an arbitrary number of arguments, which are interpreted as targets to run.targets: A list of project names, task aliases, or specific task targets (e.g.,project:task) to execute.
Flags
--no-cache
Short flag: -n
Bypass the build cache and force task execution. This is useful when you want to ensure that all tasks are re-executed regardless of their cached state.
--inspect
Short flag: -i
Inspect the TUI (Terminal User Interface) after the build completes (prevents auto-exit). By default, the same CLI exits immediately after the build finishes (whether successful or failed). Using the --inspect flag prevents auto-exit, allowing you to:
- Scroll through the logs of completed tasks.
- Inspect the state of the dependency graph.
- Review any errors in detail within the TUI.
Examples
Run a single target namedbuild:
build and test) in parallel (where dependencies allow):
Behavior
- Parallel Execution:
samewill automatically determine the dependency graph and execute tasks in parallel where possible. - Caching: By default,
samewill skip tasks that have already been computed and whose inputs haven’t changed. Use the--no-cacheflag to bypass this. - TUI: The command launches an interactive Terminal User Interface to display progress.