From 3d9652d7b5bb2acf3de29fedb26ec4fbc841ca72 Mon Sep 17 00:00:00 2001
From: D-L-Narayana <249577150+D-L-Narayana@users.noreply.github.com>
Date: Sat, 26 Sep 2026 06:20:08 +0000
Subject: [PATCH] docs: explain an empty status line in one folder (workspace
 trust)

Since Claude Code 2.1.51 a custom statusLine command only runs in a
trusted workspace, and since 2.1.232 a git repository nested under a
trusted parent folder no longer inherits that trust. Claude Code does not
always re-show the trust dialog, so in such a folder ccstatusline is never
invoked and the status line is an empty row, while running the command by
hand works and other folders are fine. It looks exactly like a
ccstatusline bug, and several repos under one parent break at once.

Add a troubleshooting entry to docs/USAGE.md with the check
(`hasTrustDialogAccepted` for the project path in ~/.claude.json) and a
pointer to it from the README next to the other quick-start notes.

Closes #552
---
 README.md     | 2 ++
 docs/USAGE.md | 6 ++++++
 2 files changed, 8 insertions(+)

diff --git a/README.md b/README.md
index 539c2d0cd..8a7073017 100644
--- a/README.md
+++ b/README.md
@@ -356,6 +356,8 @@ The interactive configuration tool provides a terminal UI where you can:
 
 > 🪟 **Windows Support:** PowerShell examples, installation notes, fonts, troubleshooting, WSL, and Windows Terminal configuration are in [docs/WINDOWS.md](docs/WINDOWS.md).
 
+> 🫥 **Status line empty in one folder?** Claude Code only runs the status line command in trusted workspaces, and nested git repositories stopped inheriting trust in Claude Code 2.1.232. See [Status line empty in one folder](docs/USAGE.md#status-line-empty-in-one-folder-but-fine-elsewhere).
+
 </details>
 
 <details>
diff --git a/docs/USAGE.md b/docs/USAGE.md
index 62cd88bcf..3901b9da0 100644
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@@ -176,6 +176,12 @@ The same menu controls these ccstatusline cache settings, saved with **Save & Ex
 
 Git commands run on cache misses with a five-second timeout. A timed-out command follows the normal missing-data path for its widget.
 
+### Status line empty in one folder but fine elsewhere
+
+Claude Code only runs a custom `statusLine` command in a workspace whose trust dialog has been accepted (since Claude Code 2.1.51). Since 2.1.232, a git repository nested under an already-trusted parent folder no longer inherits that trust, and Claude Code does not always show the trust dialog again. In such a folder, ccstatusline is never invoked, so the status line renders as an empty row even though running `ccstatusline` by hand in the same folder works and other folders still show it.
+
+To confirm, look up the project path in `~/.claude.json` under `projects` and check its `hasTrustDialogAccepted` value. Setting it to `true` (or accepting the trust dialog when Claude Code shows it) and starting a new session restores the status line.
+
 ## Usage Credentials and Cache
 
 Usage API requests read credentials from the active Claude config directory's `.credentials.json` on Linux and Windows. On macOS, a custom `CLAUDE_CONFIG_DIR` selects its matching Keychain service first, then falls back only to that profile's credentials file. `CLAUDE_SECURESTORAGE_CONFIG_DIR`, when set, overrides the value used to select the Keychain service; an empty value selects the default service lookup. With the default service lookup, ccstatusline tries `Claude Code-credentials`, then matching suffixed services, then the credentials file.