diff --git a/README.md b/README.md
index aac68c8a..1c28de87 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,41 @@ npx perstack-demo-dungeon-crawler start
 
 </details>
 
+### Viewing run history
+
+`perstack log` provides a TUI for browsing past runs and their delegation trees. Every delegation — who called whom, what succeeded, what failed — is visible at a glance:
+
+```
+Runs (create-expert) Enter:Select b:Back q:Quit
+ > ✓ create-expert Form a team named bash-gaming. They build indie CLI games…
+   | \
+   | ✓ @create-expert/plan Create a Perstack expert definition for team…
+   | ✓ @create-expert/design-roles Design the technical architecture…
+   | | \
+   | | ✗ @create-expert/find-skill
+   | | ✗ @create-expert/find-skill
+   | | ○ @create-expert/find-skill
+   | | /
+   | ✓ @create-expert/build Build the bash-gaming perstack.toml expert…
+   | | \
+   | | ✓ @create-expert/test-expert Build a word puzzle game 'lexicon'…
+   | | | \
+   | | | ✓ bash-gaming
+   | | | | \
+   | | | | ✓ @bash-gaming/game-engine
+   | | | | ✓ @bash-gaming/tui-renderer
+   | | | | ✓ @bash-gaming/ai-mode
+   | | | | ✓ @bash-gaming/npm-dist
+   | | | | ✓ @bash-gaming/testing
+   | | | | ✓ @bash-gaming/evaluator
+   | | | | /
+   | | | /
+   | | /
+   | /
+```
+
+`✓` succeeded, `✗` failed, `○` skipped. Use `perstack log --help` for filtering and JSON output options.
+
 ### Integrating with your app
 
 Perstack separates the agent harness from the application layer. Your app stays a normal web or terminal app, with no LLM dependencies in the client.