bleep compile
compile selected projects (or every project), respects the dependency graph; supports watch mode
Synopsis
bleep compile <project name...> [flags]
Arguments
| Argument | Type |
|---|---|
project name | one or more |
Flags
| Flag | Description |
|---|---|
--watch, -w | start in watch mode |
--invalidated <base ref> | build only what a git diff invalidated: projects whose sources or config changed vs a base ref, plus every project transitively depending on them. Bare --invalidated compares against this branch's upstream, --invalidated=<ref> against that ref. Nothing invalidated builds nothing |
--no-tui | disable TUI, keep the full streaming trace (for CI/agents that read logs) |
--quiet, -q | only failures and the final summary |
--diff-watch | watch mode with per-project diffs between cycles |
--flamegraph | generate execution trace (open in chrome://tracing or ui.perfetto.dev) |
--cancel | cancel any running build before starting |
--diff <history id> | after the run, print only what changed vs a recorded run: bare --diff compares against the most recent compile (with --watch: the previous cycle), --diff=<id> against that history entry (with --watch: a fixed baseline for every cycle) |
--output, -o <string> | with --diff: 'text' renders the diff for humans (default), 'json' prints the diff document |
See also
The run history & diffs guide tells the whole story — what
gets recorded, diffing runs, the --diff edit loop, cross-worktree comparisons — with
a demo video.