From f617c8cb738efe9efb8a2f0c49158715473fb45c Mon Sep 17 00:00:00 2001
From: goodboy <goodboy_foss@protonmail.com>
Date: Thu, 14 May 2026 13:02:22 -0400
Subject: [PATCH] Add `acli.ptree` poll .xsh snippet to docstr

---
 xontrib/tractor_diag.xsh | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/xontrib/tractor_diag.xsh b/xontrib/tractor_diag.xsh
index 273a30fb..30252bb8 100644
--- a/xontrib/tractor_diag.xsh
+++ b/xontrib/tractor_diag.xsh
@@ -69,6 +69,16 @@ def _ptree(args):
     See `tractor._testing.trace.dump_proc_tree()` for the
     bucket semantics + classification details.
 
+    As a hot tip, you can use this `xonsh`-script snippet to poll
+    a target actor tree:
+
+    .. code-block:: xonsh
+
+        while 1:
+            acli.ptree pytest
+            @.imp.time.sleep(.3)
+            print("\033c", end="")
+
     '''
     flag_tree: bool = False
     pos_args: list = []