bmad-code-org · pbean · Jun 21, 2026 · Jun 21, 2026 · Jun 21, 2026 · Jun 21, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -12,7 +12,7 @@
       "name": "bauto",
       "source": "./src/automator/data/skills",
       "description": "Automation-mode skills driven by the bmad-auto orchestrator: unattended dev (bmad-auto-dev), adversarial review (bmad-auto-review), and deferred-work sweep triage (bmad-auto-sweep)",
-      "version": "0.6.0",
+      "version": "0.6.1",
       "author": {
         "name": "pinkyd"
       },

diff --git a/.gitignore b/.gitignore
@@ -11,3 +11,4 @@ build/
 dist/
 _bmad/
 dev/skills/bmad-release/
+RELEASING.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,20 @@ All notable changes to `bmad-auto` are documented here. The format is based on
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html). While the project is pre-1.0,
 breaking changes may land in a minor release.
 
+## [0.6.1] — 2026-06-20
+
+### Added
+
+- **Short run refs (Docker-style).** Every command that takes a run id (`status`, `attach`,
+  `resume`, `resolve`, `stop`, `delete`, `archive`) now accepts a partial — the tail after the
+  last `-` (e.g. `a1b2`, or as few chars as stay unique). Full ids still work; an ambiguous ref
+  fails listing the candidates. New `bmad-auto list` (alias `ls`) prints each run/sweep with its
+  short ref, type, and status.
+- **Flexible `--story` selection.** `bmad-auto run --story` now takes more than the exact full
+  key: an epic+number (`--epic 3 --story 1`, `--story 3-1`, or `--story 3.1`) or a slug fragment
+  (`--story user-auth`). Full keys still work. Mismatches are caught before the run launches with a
+  targeted error — no match, ambiguous slug, or matched-but-not-actionable.
+
 ## [0.6.0] — 2026-06-20
 
 ### Fixed
@@ -415,6 +429,7 @@ enforced in CI.
   implementation phase, driven by a Python control loop with hook-based session transport and
   resumable on-disk run state.
 
+[0.6.1]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.6.1
 [0.6.0]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.6.0
 [0.5.0]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.5.0
 [0.4.4]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.4.4

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -90,15 +90,15 @@ trunk fmt        # auto-format changed files
 trunk check      # lint + format verification (what CI runs)
 ```
 
-Releases are cut by maintainers — see [RELEASING.md](RELEASING.md) for the version-bump and changelog workflow. The version field is validated in CI; if you touch it, run `uv run --no-project python scripts/sync_version.py --check`.
+Releases are cut by maintainers. The version field is validated in CI; if you touch it, run `uv run --no-project python scripts/sync_version.py --check`.
 
 ---
 
 ## Pull Request Guidelines
 
 ### Target Branch
 
-Submit PRs to the `main` branch. We use trunk-based development. Releases are cut from `main` (see [RELEASING.md](RELEASING.md)).
+Submit PRs to the `main` branch. We use trunk-based development. Releases are cut from `main`.
 
 ### PR Size
 

diff --git a/README.md b/README.md
@@ -67,6 +67,7 @@ bmad-auto tui                    # …or drive everything from the dashboard
 | `bmad-auto resume <run-id>`   | Continue a run paused at a gate, escalation, or interruption.                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `bmad-auto resolve <run-id>`  | Resolve a CRITICAL escalation: open an interactive resolve agent to fix the frozen spec, then re-arm the story and resume. `--story KEY`, `--no-interactive`, `--resume` / `--no-resume`.                                                                                                                                                                                                                                                                                          |
 | `bmad-auto decisions`         | Answer deferred-work decisions earlier sweeps left unanswered (skipped by `--no-prompt`, or an abandoned interactive sweep). Recorded so the next sweep acts on them without re-asking. `--list` shows them without answering.                                                                                                                                                                                                                                                     |
+| `bmad-auto list` (`ls`)       | List every run/sweep with its short ref, type, and status — the handle you pass to the commands below.                                                                                                                                                                                                                                                                                                                                                                             |
 | `bmad-auto status [<run-id>]` | Run + sprint summary with per-story token totals (plus a count of decisions awaiting an answer).                                                                                                                                                                                                                                                                                                                                                                                   |
 | `bmad-auto attach [<run-id>]` | tmux-attach to a run's live agent session.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `bmad-auto stop <run-id>`     | Stop a live run — the engine and its agent tmux session.                                                                                                                                                                                                                                                                                                                                                                                                                           |
@@ -76,7 +77,9 @@ bmad-auto tui                    # …or drive everything from the dashboard
 | `bmad-auto clean`             | Reclaim **disk** from concluded runs per `[cleanup]`: tear down git worktrees a mid-flight stop orphaned (freeing their Unity `Library/` + MCP-server builds), trim the heavy `worktrees/` tree from runs kept for history (they stay viewable in the TUI), and archive/delete runs past the retention window. Only finished/stopped runs are touched; `--dry-run` previews, `--keep <run-id>` protects, `--retain N` overrides the window, `--hard` deletes instead of archiving. |
 | `bmad-auto tui`               | The interactive dashboard (needs the `[tui]` extra). `--low-frame-rate` caps it to 15fps + disables animations (fixes repaint tearing over slow/SSH links; also `[tui] low_frame_rate`).                                                                                                                                                                                                                                                                                           |
 
-Every command takes `--project <dir>` (default: the current directory).
+Every command takes `--project <dir>` (default: the current directory). Any `<run-id>` may be a
+partial — the tail after the last `-` (e.g. `a1b2`), shortened to any prefix that stays unique;
+`bmad-auto list` shows each run's short ref.
 
 ## The TUI
 

diff --git a/RELEASING.md b/RELEASING.md
diff --git a/docs/FEATURES.md b/docs/FEATURES.md
@@ -161,6 +161,7 @@ See [README.md](../README.md) for the narrative overview and [setup-guide.md](se
 - `bmad-auto resume <run-id>` — continue a paused/interrupted run.
 - `bmad-auto resolve <run-id>` — resolve a CRITICAL escalation, then re-arm + resume.
 - `bmad-auto decisions` — answer deferred-work decisions past sweeps left unanswered (`--list` to just show them).
+- `bmad-auto list` (`ls`) — list every run/sweep with its short ref, type, and status.
 - `bmad-auto status [<run-id>]` — run + sprint summary with per-story token totals.
 - `bmad-auto attach [<run-id>]` — tmux-attach to a run's live agent session.
 - `bmad-auto stop <run-id>` — stop a live run (engine + agent session).
@@ -169,4 +170,4 @@ See [README.md](../README.md) for the narrative overview and [setup-guide.md](se
 - `bmad-auto cleanup` — remove leftover tmux artifacts for finished/stopped runs.
 - `bmad-auto clean` — reclaim disk from concluded runs per `[cleanup]`: tear down worktrees a mid-flight stop orphaned, trim heavy `worktrees/` from runs kept for history, archive/delete past the retention window (`--dry-run`, `--keep`, `--retain N`, `--hard`).
 - `bmad-auto tui` — the interactive dashboard (`--low-frame-rate` for slow/SSH links).
-- Every command takes `--project <dir>` (default: current directory).
+- Every command takes `--project <dir>` (default: current directory). Any `<run-id>` accepts a partial — the tail after the last `-`, shortened to any unique prefix.
diff --git a/docs/images/dashboard.png b/docs/images/dashboard.png
-Original file line number
+Diff line change
@@ Expand Up / @@ -11,3 +11,4 @@ build/ @@
     dist/
     _bmad/
     dev/skills/bmad-release/
+    RELEASING.md