From b672762be84c4d3d034c336a0bd1e46cb3ca0af0 Mon Sep 17 00:00:00 2001
From: Pheby <phebydonuts@outlook.com>
Date: Thu, 10 Sep 2026 05:47:09 +0000
Subject: [PATCH] [verified] docs: document tool_progress off for the pheby
 platform

---
 README.md      | 4 +++-
 docs/README.md | 7 +++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 483ada1..ea91b20 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,9 @@ protocol for a native Android client.
 - **Original product spec:** [docs/spec-source/](docs/spec-source/)
 
 Install: copy `plugin/pheby/` into `~/.hermes/plugins/`, set `PHEBY_SECRET`
-in `~/.hermes/.env`, enable in config.yaml, restart the gateway. See
+in `~/.hermes/.env`, enable it in config.yaml, and set
+`display.platforms.pheby.tool_progress: off` so Hermes's generic text progress
+does not duplicate the adapter's structured tool-event pill. Restart the gateway. See
 [docs/README.md](docs/README.md).
 
 Tests: `.venv/bin/python -m pytest tests/ -o addopts= -q --asyncio-mode=auto`
diff --git a/docs/README.md b/docs/README.md
index 5955be9..4b1891c 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -88,6 +88,13 @@ plugins:
   enabled:
     - pheby            # user plugins are opt-in (untrusted code gate)
 
+display:
+  platforms:
+    pheby:
+      # The client receives structured tool.event records for its native pill.
+      # Disable Hermes's generic text progress or every tool appears twice.
+      tool_progress: off
+
 platforms:
   pheby:
     enabled: true