From f4789365c3a8a4f4c173e56892cdb165cdc8b852 Mon Sep 17 00:00:00 2001 From: HiranoMasaaki Date: Thu, 12 Mar 2026 18:59:56 +0900 Subject: [PATCH] docs: add perstack log delegation tree example to README Show the TUI run history viewer with a simplified delegation tree from a real create-expert session, demonstrating how perstack log visualizes agent hierarchies and their success/failure states. Co-Authored-By: Claude Opus 4.6 --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) 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 +### 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.