Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows
docs(bench): replace --skip with positional FILTER (#2547)
Maximilian Roos05514ef44cf3
diff --git a/benches/CLAUDE.md b/benches/CLAUDE.mdindex 1c560a0c1..b07427749 100644--- a/benches/CLAUDE.md+++ b/benches/CLAUDE.md@@ -4,11 +4,13 @@ See `list.rs` and `time_to_first_output.rs` headers for benchmark groups and run## Quick Start+Criterion's CLI takes a positional `FILTER` (substring inclusion) and `--exact`. There's no `--skip`; pick a filter that *includes* what you want instead.+```bash-# Fast iteration (skip slow benchmarks)-cargo bench --bench list -- --skip cold --skip real --skip divergent_branches+# Fast iteration (one synthetic group, warm cache only)+cargo bench --bench list skeleton/warm-# Run specific group+# Run specific group (all variants)cargo bench --bench list many_branches# GH #461 scenario (200 branches on rust-lang/rust)@@ -18,8 +20,8 @@ cargo bench --bench list real_repo_many_branchescargo bench --bench list# Time-to-first-output benchmarks-cargo bench --bench time_to_first_output # all commands-cargo bench --bench time_to_first_output -- remove # just remove+cargo bench --bench time_to_first_output # all commands+cargo bench --bench time_to_first_output remove # just remove```## Rust Repo Caching@@ -28,17 +30,18 @@ Real repo benchmarks clone rust-lang/rust on first run (~2-5 minutes). The clone## Faster Iteration-**Skip slow benchmarks:**-```bash-cargo bench --bench list -- --skip cold --skip real-```+Criterion has no exclusion flag — narrow the run by picking a substring that matches only the variants you want. Benchmark IDs look like `<group>/<label>/<param>`, e.g. `skeleton/cold/4`, `worktree_scaling/warm/8`, `real_repo_many_branches/warm`.-**Pattern matching:**+**Pattern matching (positional `FILTER`):**```bash-cargo bench --bench list scaling # All scaling benchmarks-cargo bench --bench list -- --skip cold # Warm cache only+cargo bench --bench list scaling # All worktree_scaling/* variants+cargo bench --bench list warm # Every benchmark whose ID contains "warm"+cargo bench --bench list skeleton/warm # Just skeleton's warm variants+cargo bench --bench list -- --exact full/cold/4 # One exact ID```+To skip the slow real-repo and divergent groups, target the synthetic groups directly: `cargo bench --bench list skeleton`, `cargo bench --bench list full`, or `cargo bench --bench list worktree_scaling`. Run them sequentially if you want more than one.+## WORKTRUNK_FIRST_OUTPUTSetting `WORKTRUNK_FIRST_OUTPUT=1` causes commands to exit at the point where firstdiff --git a/benches/alias.rs b/benches/alias.rsindex 6b5512ae2..e1690531e 100644--- a/benches/alias.rs+++ b/benches/alias.rs@@ -22,10 +22,11 @@// context build to referenced vars only — until then with_vars tracks// stub within noise, since context build is unconditional.//-// Run examples:+// Run examples (Criterion takes a positional substring FILTER; no --skip):// cargo bench --bench alias # All variants-// cargo bench --bench alias -- --skip cold # Warm only, faster-// cargo bench --bench alias -- --skip with_vars # Stub only+// cargo bench --bench alias warm # Warm only (incl. with_vars/warm)+// cargo bench --bench alias dispatch/warm # Stub-warm only (excludes with_vars)+// cargo bench --bench alias dispatch/cold # Stub-cold only (excludes with_vars)// cargo bench --bench alias -- --sample-size 10 # Fast iterationuse criterion::{BenchmarkId, Criterion, criterion_group, criterion_main};