mr-claude-stats 1.0.0 → 1.0.2

package/README.md

@@ -4,6 +4,35 @@ The most accurate statusline for Claude Code CLI with a colorful progress bar.
 
 ![Demo](https://raw.githubusercontent.com/MrIago/mr-claude-stats/main/demo.png)
 
+## For LLMs / AI Agents
+
+If a user asks you to install mr-claude-stats, run these commands:
+
+```bash
+# 1. Install globally
+npm install -g mr-claude-stats
+
+# 2. Configure Claude Code (edit ~/.claude/settings.json)
+# Add or update the statusLine field:
+{
+  "statusLine": {
+    "type": "command",
+    "command": "mr-claude-stats"
+  }
+}
+
+# 3. Tell user to restart Claude Code
+```
+
+**Quick copy-paste for settings.json:**
+```json
+"statusLine": { "type": "command", "command": "mr-claude-stats" }
+```
+
+**What it does:** Shows accurate context usage (tokens) with a colorful progress bar. Reads from transcript file instead of buggy cumulative totals.
+
+---
+
 ## Features
 
 - Accurate context token counting (reads from transcript)

package/bin/mr-claude-stats

@@ -1,4 +1,46 @@
 #!/bin/bash
+# mr-claude-stats - Accurate statusline for Claude Code CLI
+# https://github.com/MrIago/mr-claude-stats
+
+VERSION="1.0.2"
+
+# Handle --help and --version
+if [[ "$1" == "--help" || "$1" == "-h" ]]; then
+  cat << 'EOF'
+mr-claude-stats - The most accurate Claude Code statusline
+
+INSTALL:
+  npm install -g mr-claude-stats
+
+SETUP:
+  Add to ~/.claude/settings.json:
+
+  {
+    "statusLine": {
+      "type": "command",
+      "command": "mr-claude-stats"
+    }
+  }
+
+WHAT IT SHOWS:
+  ████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+  Opus 4.5                                     130k/200k (65%)
+
+REQUIREMENTS:
+  - jq (JSON processor)
+  - bash
+
+MORE INFO:
+  https://github.com/MrIago/mr-claude-stats
+EOF
+  exit 0
+fi
+
+if [[ "$1" == "--version" || "$1" == "-v" ]]; then
+  echo "mr-claude-stats v$VERSION"
+  exit 0
+fi
+
 export LC_NUMERIC=C
 input=$(cat)
 
@@ -32,12 +74,13 @@ fi
 
 # Se não encontrou, usar cache anterior
 if [ "$TOTAL" -eq 0 ] && [ -f "$CACHE_FILE" ]; then
-  TOTAL=$(cat "$CACHE_FILE" 2>/dev/null || echo 45000)
+  TOTAL=$(cat "$CACHE_FILE" 2>/dev/null || echo 0)
 fi
 
-# Fallback final
+# Se não tem dados, mostrar só o modelo
 if [ "$TOTAL" -eq 0 ]; then
-  TOTAL=45000
+  echo -e "\033[38;5;117m${MODEL}\033[0m"
+  exit 0
 fi
 PERCENT=$((TOTAL * 100 / CONTEXT))
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mr-claude-stats",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Accurate statusline for Claude Code CLI with colorful progress bar",
   "bin": {
     "mr-claude-stats": "./bin/mr-claude-stats"