From 9b3d36038b1ee281e1756def5ad4e4430614ffa2 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

(cherry picked from commit f617c8cb738efe9efb8a2f0c49158715473fb45c)
---
 xontrib/tractor_diag.xsh | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/xontrib/tractor_diag.xsh b/xontrib/tractor_diag.xsh
index d48e40c7..83e83012 100644
--- a/xontrib/tractor_diag.xsh
+++ b/xontrib/tractor_diag.xsh
@@ -250,6 +250,17 @@ def _ptree(args):
       tree shape with no severity-grouping. Same procs,
       no annotations needed because each parent appears
       directly above its children.
+
+    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 = []