diff --git a/docs/web-ui/agent.md b/docs/web-ui/agent.md
index 0d0cb11c..bb29850c 100644
--- a/docs/web-ui/agent.md
+++ b/docs/web-ui/agent.md
@@ -372,6 +372,12 @@ cost chart), doughnuts for tool / wake-source / result mix, and a
 **result-trend** stacked bar — per-bucket `result_counts` so
 error / rate-limit / compaction outcomes are visible over time
 (the doughnut shows only the window total).
+A **favorite tools** doughnut shows the most-run shell commands —
+normalised `bash_commands` heads (argv[0] basename) written per
+bash task by the hive-bash-mcp capture, read via
+`bash_breakdown`. Its card stays hidden until the agent has run a
+bash command (a missing `bash_commands` table degrades to an empty
+list), so it never renders an empty chart.
 A summary chip row carries window totals, plus two
 token-efficiency chips derived from the bucket sums: **cache
 hit-rate** (`cache_read` over all input-side tokens) and