bleep test
run tests in selected test projects (or every isTestProject in the build)
Synopsis
bleep test <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 |
--summary-only | alias for --quiet |
--diff-watch | watch mode with per-project diffs between cycles |
--jvm-opt <string> (repeatable) | JVM options for forked test processes |
--test-arg <string> (repeatable) | arguments passed to test framework |
--only, -o <string> (repeatable) | Test only a subset of test suite class names. Class name can be fully qualified to disambiguate |
--exclude, -x <string> (repeatable) | Exclude specific test suite class names. Class name can be fully qualified to disambiguate. Takes precedence over --only |
--only-tag <tag> (repeatable) | Run only tests tagged with these names (declared in testTags per project). Multiple are OR-combined. |
--exclude-tag <tag> (repeatable) | Exclude tests tagged with these names. Takes precedence over --only-tag. |
--flamegraph | generate execution trace (open in chrome://tracing or ui.perfetto.dev) |
--cancel | cancel any running build before starting |
--junit-report <string> | write JUnit XML reports to this directory |
--diff <history id> | after the run, print only what changed vs a recorded run: bare --diff compares against the most recent test run (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.