docs: mark as unread does not work from inside claude code

2 files changed, 14 insertions, 3 deletions

diff --git a/README.md b/README.md
index c0a4c06..94729e7 100644
--- a/README.md
+++ b/README.md
@@ -106,15 +106,18 @@ than a poll is still a completion.
   it with the session, so it comes back after `/reload`, a restart, or a
   restore, and its footer shows a level other than normal. For other agents,
   run `dingger importance high|normal|low` in the agent's pane (in Claude
-  Code: `! dingger importance high`), or pass `--pane`; it lasts until the
-  agent exits.
+  Code: `! dingger importance high`, which Claude may answer with a model
+  turn), or pass `--pane`; it lasts until the agent exits.
 - **Mark as unread**: like in mail, an idle agent (one you have seen) can be
   made done again, to come back to later: right-click it in the panel's
   full list, ⌘U in agent search, `/unread` in pi, or `dingger unread
   [--pane]`. It goes last among done agents of its importance, with no
   sound or notification, and stays done until you come back to it: you
   leave its tmux window and return, or jump to it. Only idle agents can be
-  marked: a working, blocked, or done one is left alone.
+  marked: a working, blocked, or done one is left alone. Claude Code has no
+  `/unread`, and `! dingger unread` does not work in it: Claude (2.1.311)
+  answers a `!` command with a model turn, so the agent is working and the
+  mark is refused. Use the panel or search for Claude agents.
 
 ## Where state comes from
 
diff --git a/ROADMAP.md b/ROADMAP.md
index 8d9895c..485a998 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -43,6 +43,14 @@ In priority order.
 8. **Preview in agent search.** Show the last lines of the selected agent's
    pane (`tmux capture-pane`) beside the results. Not yet.
 
+Known gaps, left for now:
+
+- **Mark as unread from inside Claude Code.** `! dingger unread` starts a
+  model turn (Claude 2.1.311 answers `!` commands), so the agent is working
+  and the mark is refused; the panel and search work. A fix: a
+  `UserPromptSubmit` hook that catches a typed `/unread`, marks the agent,
+  and drops the prompt before it reaches the model.
+
 The rest of pi 1.0.4 to 1.4.0 (models, codemode, configuration schemas,
 clipboard, `/share`) does not touch dingger. pi 1.3's resumed sessions
 keep their active tools, so a restore brings those back too.