@the-bearded-bear/claude-craft 7.9.0 → 7.10.0-next.79ddea4

package/README.md

@@ -6,10 +6,10 @@
 
 A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks.
 
-## What's New in v7.9
+## What's New in v7.10
 
-- **Multi-account tool v2** — chmod 0700 security, `doctor` command, `--json` output, standardized exit codes, `.claude-profile` auto-switch, bash/zsh completions, 23 bats tests
-- **5-language i18n** — 29 new keys across en/fr/es/de/pt for doctor, permissions, JSON output
+- **Status Line v2.0** — fixed `settings.json` format, native `context_window` %, single jq call (7→1), git cache, 13 toggles, agent name, vim mode, burn rate, progress bar styles, compact/detailed modes, `--version`/`--help`, 27 bats tests
+- **Multi-account tool v2** — `doctor` command, `--json` output, exit codes, `.claude-profile` auto-switch, bash/zsh completions, 23 bats tests
 - See [CHANGELOG](CHANGELOG.md) for full details
 
 > See [CHANGELOG.md](CHANGELOG.md) for previous versions.

package/Tools/StatusLine/README.md

@@ -1,160 +1,199 @@
-# Claude Code Status Line
+# Claude Code Status Line v2.0
 
-Affiche une status line personnalisée dans Claude Code avec des informations contextuelles.
+A customizable status line for Claude Code displaying contextual information.
 
-## Aperçu
+## Preview
 
+**Compact mode** (default, 1 line):
 ```
-🔑 pro | 🧠 Opus | 🌿 main +2~1 | 📁 mon-projet | 📊 45% | ⏱️ 5h: 23% | 📅 Sem: 45% | 💰 $0.42 | 🕐 14:32
+🔑 pro | 🧠 Opus | 🌿 main +2~1 | 📁 my-project | 📊 42% | ⏱️ 5h: 23% | 📅 Sem: 45% | 💰 $0.42 | 🕐 14:32
 ```
 
-### Éléments affichés
+**Detailed mode** (2 lines):
+```
+🔑 pro | 🧠 Opus | 🌿 main +2~1 | 📁 my-project | @agent | NORMAL
+📊 [▓▓▓▓░░░░░░] 42% | 💰 $0.42 ($0.12/min) | +156 -23 | ⏱️ 5h: 23% | 📅 Sem: 45% | 🕐 14:32
+```
 
-| Emoji | Info | Description |
-|-------|------|-------------|
-| 🔑 | Profil | Compte Claude actif (via `CLAUDE_CONFIG_DIR`) |
-| 🧠/🎵/🍃 | Modèle | Opus/Sonnet/Haiku |
-| 🌿 | Git | Branche + status (+staged ~modified ?untracked) |
-| 📁 | Projet | Nom du répertoire projet |
-| 📊 | Contexte | % utilisé (vert < 60%, jaune < 80%, rouge ≥ 80%) |
-| ⏱️ | Session | % limite session 5h utilisée (via ccusage) |
-| 📅 | Hebdo | % limite hebdomadaire utilisée (via ccusage) |
-| 💰 | Coût | Coût session en USD |
-| 🕐 | Heure | Heure actuelle |
+### Elements
+
+| Emoji | Element | Description |
+|-------|---------|-------------|
+| 🔑 | Profile | Active Claude account (via `CLAUDE_CONFIG_DIR`) |
+| 🧠/🎵/🍃 | Model | Opus / Sonnet / Haiku |
+| 🌿 | Git | Branch + status (+staged ~modified ?untracked) |
+| 📁 | Project | Project directory name |
+| @ | Agent | Current agent name (when using agents) |
+| | Vim mode | NORMAL / INSERT (when vim mode enabled) |
+| 📊 | Context | % context window used (percentage, bar, or both) |
+| ⏱️ | Session | % session limit used (via ccusage) |
+| 📅 | Weekly | % weekly limit used (via ccusage) |
+| 💰 | Cost | Session cost in USD (+ optional burn rate $/min) |
+| 🕐 | Time | Current time |
 
 ## Installation
 
-### 1. Copier le script
+### 1. Copy the script
 
 ```bash
 mkdir -p ~/.claude
 cp statusline.sh ~/.claude/statusline.sh
+cp statusline.conf.example ~/.claude/statusline.conf
 chmod +x ~/.claude/statusline.sh
 ```
 
-### 2. Configurer Claude Code
+### 2. Configure Claude Code
 
-Fusionne avec ton `~/.claude/settings.json` existant :
+Merge into your `~/.claude/settings.json`:
 
 ```json
 {
   "statusLine": {
-    "enabled": true,
-    "script": "~/.claude/statusline.sh"
+    "type": "command",
+    "command": "~/.claude/statusline.sh"
   }
 }
 ```
 
-### 3. Installer les dépendances
+### 3. Install dependencies
 
 ```bash
-# jq est requis pour parser le JSON
+# jq is required for JSON parsing
 # macOS
 brew install jq
 
 # Linux (Debian/Ubuntu)
 sudo apt install jq
 
-# ccusage (optionnel, pour tracking avancé des coûts)
+# ccusage (optional — for session/weekly usage tracking)
 npm install -g ccusage
 ```
 
-### 4. Configurer les profils multiples (optionnel)
-
-Voir `Tools/MultiAccount/` pour gérer plusieurs comptes Claude Code.
-
-## Personnalisation
-
-### Configurer les limites d'utilisation
-
-Copie le fichier de configuration exemple et ajuste les valeurs selon ton abonnement :
+### 4. Verify
 
 ```bash
-cp statusline.conf.example ~/.claude/statusline.conf
-```
-
-Édite `~/.claude/statusline.conf` :
+# Check version
+bash ~/.claude/statusline.sh --version
 
-```bash
-# Limites de session (approximation 5h)
-SESSION_COST_LIMIT=25.00     # En dollars
+# Test with sample JSON
+echo '{"model":{"display_name":"Opus","id":"claude-opus-4-6"},"context_window":{"used_percentage":42},"cost":{"total_cost_usd":0.5},"workspace":{"current_dir":"/tmp/test","project_dir":"/tmp/test"}}' | bash ~/.claude/statusline.sh
+```
 
-# Limites hebdomadaires
-WEEKLY_COST_LIMIT=150.00     # En dollars
+## Configuration
 
-# Seuils d'alerte
-USAGE_WARN_THRESHOLD=60      # Jaune à partir de 60%
-USAGE_CRIT_THRESHOLD=80      # Rouge à partir de 80%
+Edit `~/.claude/statusline.conf` (copied from `statusline.conf.example`):
 
-# Cache (évite les appels répétés à ccusage)
-SESSION_CACHE_TTL=60         # Rafraîchissement toutes les 60s
-WEEKLY_CACHE_TTL=300         # Rafraîchissement toutes les 5min
+### Element Toggles
 
-# Affichage (true/false)
-SHOW_SESSION_LIMIT=true
-SHOW_WEEKLY_LIMIT=true
+Every element can be shown or hidden independently:
 
-# Labels personnalisés
-SESSION_LABEL="⏱️ 5h"
-WEEKLY_LABEL="📅 Sem"
+```bash
+SHOW_PROFILE=true          # 🔑 Profile name
+SHOW_MODEL=true            # 🧠 Model name
+SHOW_GIT=true              # 🌿 Git branch + status
+SHOW_PROJECT=true          # 📁 Project name
+SHOW_CONTEXT=true          # 📊 Context percentage
+SHOW_COST=true             # 💰 Session cost
+SHOW_TIME=true             # 🕐 Current time
+SHOW_AGENT=true            # @ Agent name (auto)
+SHOW_VIM_MODE=true         # Vim mode (auto)
+SHOW_SESSION_LIMIT=true    # ⏱️ Session usage %
+SHOW_WEEKLY_LIMIT=true     # 📅 Weekly usage %
+SHOW_BURN_RATE=false       # $/min (opt-in)
+SHOW_LINES_CHANGED=false   # +N -M lines (opt-in)
 ```
 
-### Modifier les seuils de contexte
-
-Édite `~/.claude/statusline.sh` :
+### Display Mode
 
 ```bash
-CONTEXT_WARN_THRESHOLD=60   # Jaune à partir de 60%
-CONTEXT_CRIT_THRESHOLD=80   # Rouge à partir de 80%
+STATUSLINE_MODE=compact    # compact (1 line) or detailed (2 lines)
 ```
 
-### Ajouter/retirer des éléments
-
-Commente ou décommente les sections dans la partie "CONSTRUCTION DE LA STATUS LINE" du script.
+### Context Bar Style
 
-### Changer les emojis
-
-Modifie la fonction `get_model_emoji()` ou les lignes d'output.
-
-## Troubleshooting
-
-### La status line ne s'affiche pas
-
-1. Vérifie que le script est exécutable : `ls -la ~/.claude/statusline.sh`
-2. Teste manuellement : `echo '{"model":{"display_name":"Test"}}' | ~/.claude/statusline.sh`
-3. Vérifie les logs Claude Code
-
-### Le coût affiche toujours $0.00
+```bash
+CONTEXT_BAR_STYLE=percentage   # "42%"
+# CONTEXT_BAR_STYLE=bar        # "[▓▓▓▓░░░░░░]"
+# CONTEXT_BAR_STYLE=both       # "[▓▓▓▓░░░░░░] 42%"
+```
 
-- Installe ccusage : `npm install -g ccusage`
-- Le coût peut mettre quelques secondes à se mettre à jour
+### Usage Limits
 
-### Les limites 5h/Hebdo ne s'affichent pas
+Adjust for your Claude subscription plan:
 
-- ccusage doit être installé : `npm install -g ccusage`
-- Vérifie que npx fonctionne : `npx ccusage daily --json`
-- Les données apparaissent seulement s'il y a de l'usage (> 0%)
-- Le cache peut retarder l'affichage (60s pour session, 5min pour hebdo)
+```bash
+# Pro ($20/month)
+SESSION_COST_LIMIT=25.00
+WEEKLY_COST_LIMIT=150.00
 
-### Les pourcentages semblent incorrects
+# Max 5x ($100/month)
+SESSION_COST_LIMIT=125.00
+WEEKLY_COST_LIMIT=750.00
 
-Les limites sont des estimations que tu définis dans `statusline.conf`.
-Ajuste `SESSION_COST_LIMIT` et `WEEKLY_COST_LIMIT` selon ton expérience d'utilisation.
+# Max 20x ($200/month) — default
+SESSION_COST_LIMIT=500.00
+WEEKLY_COST_LIMIT=3000.00
+```
 
-### Le contexte % semble incorrect
+### Alert Thresholds
 
-L'estimation est basée sur la taille du fichier transcript (~4MB = 100%).
-Ajuste `max_size` dans la fonction `get_context_percent()` si nécessaire.
+```bash
+CONTEXT_WARN_THRESHOLD=60    # Yellow at 60%
+CONTEXT_CRIT_THRESHOLD=80    # Red at 80%
+USAGE_WARN_THRESHOLD=60
+USAGE_CRIT_THRESHOLD=80
+```
 
-## Commandes utiles
+### Cache TTL
 
 ```bash
-# Voir l'usage du jour avec ccusage
-npx ccusage daily
+SESSION_CACHE_TTL=60     # Session usage cache (seconds)
+WEEKLY_CACHE_TTL=300     # Weekly usage cache (seconds)
+GIT_CACHE_TTL=5          # Git status cache (seconds)
+```
 
-# Monitoring live
-npx ccusage blocks --live
+## Troubleshooting
 
-# Usage par projet
-npx ccusage daily --instances
-```
+### Status line not showing
+
+1. Verify the script is executable: `ls -la ~/.claude/statusline.sh`
+2. Check settings.json format — must use `"type": "command"`:
+   ```bash
+   cat ~/.claude/settings.json | jq '.statusLine'
+   # Expected: { "type": "command", "command": "~/.claude/statusline.sh" }
+   ```
+3. Test manually: `echo '{"model":{"display_name":"Test"}}' | ~/.claude/statusline.sh`
+4. Verify jq is installed: `which jq`
+
+### Cost always shows $0.00
+
+Claude Code provides `cost.total_cost_usd` natively. If it shows 0, the session may have just started.
+
+### Session/Weekly limits not showing
+
+- Install ccusage globally: `npm install -g ccusage`
+- Verify it works: `ccusage daily --json`
+- Values only appear when usage > 0%
+- Cache may delay display (60s session, 5min weekly)
+
+### Context % seems incorrect
+
+v2.0 reads `context_window.used_percentage` natively from Claude Code.
+Falls back to transcript size estimation only if native value is unavailable.
+
+## What's New in v2.0
+
+- **Fixed settings.json format** — uses correct `"type": "command"` format
+- **Native context window** — reads `context_window.used_percentage` from Claude Code
+- **Single jq call** — 7 separate jq invocations replaced by 1 (performance)
+- **Cross-platform** — `stat` helper works on both Linux and macOS
+- **Git cache** — git status cached for 5s to reduce overhead
+- **Progress bar** — context can display as `[▓▓▓▓░░░░░░]`
+- **Detailed mode** — 2-line layout with identity + metrics
+- **Agent name** — shows `@agent-name` when using agents
+- **Vim mode** — shows NORMAL/INSERT when vim mode is enabled
+- **Burn rate** — optional $/min display
+- **Lines changed** — optional +N -M from Claude Code
+- **Full toggles** — every element individually toggleable
+- **--version / --help** flags
+- **Global ccusage preferred** — avoids slow `npx --yes` downloads

package/Tools/StatusLine/settings.json

@@ -1,6 +1,6 @@
 {
   "statusLine": {
-    "enabled": true,
-    "script": "~/.claude/statusline.sh"
+    "type": "command",
+    "command": "~/.claude/statusline.sh"
   }
 }

package/Tools/StatusLine/statusline.conf.example

@@ -1,75 +1,100 @@
 # =============================================================================
-# Claude Code Status Line - Configuration des limites d'utilisation
+# Claude Code Status Line v2.0 — Configuration
 # =============================================================================
 #
-# Copier ce fichier vers ~/.claude/statusline.conf et ajuster les valeurs
-# selon votre abonnement Claude (Pro, Max, etc.)
+# Copy to ~/.claude/statusline.conf and adjust values for your plan.
 #
-# Installation:
 #   cp statusline.conf.example ~/.claude/statusline.conf
 #
 # =============================================================================
 
 # =============================================================================
-# LIMITES DE SESSION (approximation période 5h)
+# SESSION LIMITS (approximate 5h window)
 # =============================================================================
-# Note: Claude Code n'expose pas les vraies limites, ces valeurs sont des
-# estimations basées sur votre expérience d'utilisation.
+# Claude Code doesn't expose real limits. These are estimates based on usage.
 #
-# Valeurs recommandées par plan (en dollars):
-#   - Pro ($20/mois)     : SESSION=25,   WEEKLY=150
-#   - Max 5x ($100/mois) : SESSION=125,  WEEKLY=750
-#   - Max 20x ($200/mois): SESSION=500,  WEEKLY=3000
+# Recommended values by plan (in USD):
+#   - Pro ($20/month)     : SESSION=25,   WEEKLY=150
+#   - Max 5x ($100/month) : SESSION=125,  WEEKLY=750
+#   - Max 20x ($200/month): SESSION=500,  WEEKLY=3000
 #
-# En dollars (recommandé - plus stable que les tokens)
 SESSION_COST_LIMIT=500.00
 
-# OU en tokens (décommenter si préféré, commenter SESSION_COST_LIMIT)
-# SESSION_TOKEN_LIMIT=500000
-
 # =============================================================================
-# LIMITES HEBDOMADAIRES
+# WEEKLY LIMITS
 # =============================================================================
-# Estimation de votre quota hebdomadaire selon votre plan
-#
-# En dollars
 WEEKLY_COST_LIMIT=3000.00
 
-# OU en tokens
-# WEEKLY_TOKEN_LIMIT=3000000
-
 # =============================================================================
-# SEUILS D'ALERTE (pourcentage)
+# ALERT THRESHOLDS (percentage)
 # =============================================================================
-# Couleur de l'indicateur selon le pourcentage utilisé:
-#   - Vert  : < USAGE_WARN_THRESHOLD
-#   - Jaune : USAGE_WARN_THRESHOLD - USAGE_CRIT_THRESHOLD
-#   - Rouge : > USAGE_CRIT_THRESHOLD
+# Color changes based on percentage used:
+#   - Green  : < WARN threshold
+#   - Yellow : WARN — CRIT
+#   - Red    : > CRIT threshold
+
+# Context window thresholds
+CONTEXT_WARN_THRESHOLD=60
+CONTEXT_CRIT_THRESHOLD=80
 
+# Usage (session/weekly) thresholds
 USAGE_WARN_THRESHOLD=60
 USAGE_CRIT_THRESHOLD=80
 
 # =============================================================================
 # CACHE (performance)
 # =============================================================================
-# Durée du cache en secondes pour éviter les appels répétés à ccusage
-# (ccusage peut être lent à démarrer via npx)
+# TTL in seconds to avoid repeated calls to ccusage
 
-# Cache pour l'usage de session (rafraîchi plus souvent)
+# Session usage cache (refreshed more often)
 SESSION_CACHE_TTL=60
 
-# Cache pour l'usage hebdomadaire (change moins vite)
+# Weekly usage cache (changes less frequently)
 WEEKLY_CACHE_TTL=300
 
+# Git status cache (branch + staged/unstaged counts)
+GIT_CACHE_TTL=5
+
 # =============================================================================
-# AFFICHAGE
+# ELEMENT TOGGLES
 # =============================================================================
-# Activer/désactiver l'affichage des limites
-# Mettre à "false" pour masquer un indicateur
+# Set to "false" to hide an element from the status line
 
+SHOW_PROFILE=true
+SHOW_MODEL=true
+SHOW_GIT=true
+SHOW_PROJECT=true
+SHOW_CONTEXT=true
+SHOW_COST=true
+SHOW_TIME=true
+SHOW_AGENT=true
+SHOW_VIM_MODE=true
 SHOW_SESSION_LIMIT=true
 SHOW_WEEKLY_LIMIT=true
 
-# Labels personnalisés (avec emoji)
+# Opt-in elements (disabled by default)
+SHOW_BURN_RATE=false
+SHOW_LINES_CHANGED=false
+
+# =============================================================================
+# DISPLAY MODE
+# =============================================================================
+# compact  : Single line (default)
+# detailed : Two lines — identity on top, metrics below
+
+STATUSLINE_MODE=compact
+
+# =============================================================================
+# CONTEXT BAR STYLE
+# =============================================================================
+# percentage : "42%"           (default)
+# bar        : "[▓▓▓▓░░░░░░]"
+# both       : "[▓▓▓▓░░░░░░] 42%"
+
+CONTEXT_BAR_STYLE=percentage
+
+# =============================================================================
+# LABELS
+# =============================================================================
 SESSION_LABEL="⏱️ 5h"
 WEEKLY_LABEL="📅 Sem"