This is a meta issue to group all the items to improve the UX of the tachyon profiler.

Tasks

CLI

• Standardize timing arguments — Currently mixing µs and seconds for related timing args, which is confusing
• Duration should default to "until done" - The fact that we sample only for 10 seconds by default is confusing to users and a bad experience

Workflow

• Auto-open browser with results — Reduce manual steps in the workflow; add --no-browser flag to disable

Flamegraph

• Hide runner/bootstrap frames by default — Top rows showing interpreter startup aren't useful for most profiling tasks
• The Gil/gc/exception indicators could be progress bars — this probably will show the information more clearly and take less space
• Show module names instead of full file paths — /home/user/project/pkg/mod.py → pkg.mod for readability
• Show "self" time for functions — Display time spent in function body excluding callees, not just total inclusive time
• Move hotspots to top of sidebar — This is the most important info; currently buried below logo and stats
• Fix inverted flamegraph width — Currently shows narrow chart when leaves sum to small percentage, wasting screen space

Pstats

• Fix docs: -o output format — Docs imply text output but it's actually binary pstats format
• Standardize --pstats behavior — Output format differs significantly with/without -o flag, which is unexpected

Thanks @dmoisset 🖤

Linked PRs

• gh-142927: Tachyon: Comma separate thousands and fix singular/plurals #142934
• gh-142927: Tachyon: Fix contrast ratio in top panel #142936
• gh-142927: Tachyon: Start with user's default light/dark theme #142987
• gh-142927: Auto-open HTML output in browser after generation #143178
• gh-142927: Fix heatmap caller navigation for interior lines #143180
• gh-142927: Hide _sync_coordinator frames from profiler output #143337
• gh-142927: Clarify pstats file output in docs and CLI #143388
• gh-142927: Detect system theme in flame graph like in heatmap #144885
• gh-142927: Tachyon: Fix singular and plurals #145329
• gh-142927: Move hotspots up flamegraph sidebar #145428
• gh-142927: Show module names instead of file paths in flamegraph #146040
• gh-142927: Show self time in flamegraph tooltip #147706
• gh-142927: Add scrollbar support to Tachyon HTML dark mode #148118
• gh-142927: Fix inverted flamegraph width #148568