setup-remembrall

Setup Remembrall Bridge (Manual Fallback)

Note: Since v2.3.0, the bridge auto-configures on first session start. You only need this command if auto-setup failed or you want to customize the Remembrall gauge.

Remembrall needs a small bridge in your Claude Code status line to feed context window % to its hooks. This command helps you add it.

You MUST complete ALL steps below (1–10). Do not stop after the bridge — the gauge and optional features are part of the setup flow.

What the Bridge Does

Your status line already has access to $remaining (context window % remaining) and $session_id. The bridge writes $remaining to a file in /tmp/claude-context-pct/ named by session_id. Each Claude session gets its own bridge file.

Steps

1. Check if the bridge already exists — Run:

   grep -q "claude-context-pct" ~/.claude/settings.json 2>/dev/null && echo "Bridge already installed" || echo "Bridge not found"
   

2. If already installed: Tell the user "Remembrall bridge is already set up." and continue to step 7.

3. If not installed: Read the user's current ~/.claude/settings.json and find the statusLine section.

4. Find the insertion point — Look for the block that checks if [ -n "$remaining" ]. The bridge snippet goes inside this block, before the closing fi.

5. Show the user the bridge snippet they need to add inside their existing if [ -n "$remaining" ]; then ... fi block. The snippet requires $session_id to be extracted earlier in the status line (add session_id=$(echo "$input" | jq -r '.session_id // empty'); alongside the other extractions):

CTX_DIR="/tmp/claude-context-pct"; mkdir -p "$CTX_DIR" 2>/dev/null;
printf "%s" "$remaining" > "$CTX_DIR/${session_id}" 2>/dev/null;

1. Edit the settings file — Insert the bridge snippet into the status line command. The exact location depends on the user's existing status line format. Find the if [ -n "$remaining" ] block and add the bridge snippet inside it (after the existing context display logic, before the fi).