@the-bearded-bear/claude-craft 3.0.0

package/Tools/StatusLine/README.md

@@ -0,0 +1,160 @@
+# Claude Code Status Line
+
+Affiche une status line personnalisée dans Claude Code avec des informations contextuelles.
+
+## Aperçu
+
+```
+🔑 pro | 🧠 Opus | 🌿 main +2~1 | 📁 mon-projet | 📊 45% | ⏱️ 5h: 23% | 📅 Sem: 45% | 💰 $0.42 | 🕐 14:32
+```
+
+### Éléments affichés
+
+| 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 |
+
+## Installation
+
+### 1. Copier le script
+
+```bash
+mkdir -p ~/.claude
+cp statusline.sh ~/.claude/statusline.sh
+chmod +x ~/.claude/statusline.sh
+```
+
+### 2. Configurer Claude Code
+
+Fusionne avec ton `~/.claude/settings.json` existant :
+
+```json
+{
+  "statusLine": {
+    "enabled": true,
+    "script": "~/.claude/statusline.sh"
+  }
+}
+```
+
+### 3. Installer les dépendances
+
+```bash
+# jq est requis pour parser le JSON
+# macOS
+brew install jq
+
+# Linux (Debian/Ubuntu)
+sudo apt install jq
+
+# ccusage (optionnel, pour tracking avancé des coûts)
+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 :
+
+```bash
+cp statusline.conf.example ~/.claude/statusline.conf
+```
+
+Édite `~/.claude/statusline.conf` :
+
+```bash
+# Limites de session (approximation 5h)
+SESSION_COST_LIMIT=25.00     # En dollars
+
+# Limites hebdomadaires
+WEEKLY_COST_LIMIT=150.00     # En dollars
+
+# Seuils d'alerte
+USAGE_WARN_THRESHOLD=60      # Jaune à partir de 60%
+USAGE_CRIT_THRESHOLD=80      # Rouge à partir de 80%
+
+# 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
+
+# Affichage (true/false)
+SHOW_SESSION_LIMIT=true
+SHOW_WEEKLY_LIMIT=true
+
+# Labels personnalisés
+SESSION_LABEL="⏱️ 5h"
+WEEKLY_LABEL="📅 Sem"
+```
+
+### Modifier les seuils de contexte
+
+Édite `~/.claude/statusline.sh` :
+
+```bash
+CONTEXT_WARN_THRESHOLD=60   # Jaune à partir de 60%
+CONTEXT_CRIT_THRESHOLD=80   # Rouge à partir de 80%
+```
+
+### Ajouter/retirer des éléments
+
+Commente ou décommente les sections dans la partie "CONSTRUCTION DE LA STATUS LINE" du script.
+
+### 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
+
+- Installe ccusage : `npm install -g ccusage`
+- Le coût peut mettre quelques secondes à se mettre à jour
+
+### Les limites 5h/Hebdo ne s'affichent pas
+
+- 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)
+
+### Les pourcentages semblent incorrects
+
+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.
+
+### Le contexte % semble incorrect
+
+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.
+
+## Commandes utiles
+
+```bash
+# Voir l'usage du jour avec ccusage
+npx ccusage daily
+
+# Monitoring live
+npx ccusage blocks --live
+
+# Usage par projet
+npx ccusage daily --instances
+```

package/Tools/StatusLine/settings.json

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

package/Tools/StatusLine/statusline.conf.example

@@ -0,0 +1,75 @@
+# =============================================================================
+# Claude Code Status Line - Configuration des limites d'utilisation
+# =============================================================================
+#
+# Copier ce fichier vers ~/.claude/statusline.conf et ajuster les valeurs
+# selon votre abonnement Claude (Pro, Max, etc.)
+#
+# Installation:
+#   cp statusline.conf.example ~/.claude/statusline.conf
+#
+# =============================================================================
+
+# =============================================================================
+# LIMITES DE SESSION (approximation période 5h)
+# =============================================================================
+# Note: Claude Code n'expose pas les vraies limites, ces valeurs sont des
+# estimations basées sur votre expérience d'utilisation.
+#
+# 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
+#
+# 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
+# =============================================================================
+# 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)
+# =============================================================================
+# Couleur de l'indicateur selon le pourcentage utilisé:
+#   - Vert  : < USAGE_WARN_THRESHOLD
+#   - Jaune : USAGE_WARN_THRESHOLD - USAGE_CRIT_THRESHOLD
+#   - Rouge : > USAGE_CRIT_THRESHOLD
+
+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)
+
+# Cache pour l'usage de session (rafraîchi plus souvent)
+SESSION_CACHE_TTL=60
+
+# Cache pour l'usage hebdomadaire (change moins vite)
+WEEKLY_CACHE_TTL=300
+
+# =============================================================================
+# AFFICHAGE
+# =============================================================================
+# Activer/désactiver l'affichage des limites
+# Mettre à "false" pour masquer un indicateur
+
+SHOW_SESSION_LIMIT=true
+SHOW_WEEKLY_LIMIT=true
+
+# Labels personnalisés (avec emoji)
+SESSION_LABEL="⏱️ 5h"
+WEEKLY_LABEL="📅 Sem"

package/Tools/StatusLine/statusline.sh

@@ -0,0 +1,351 @@
+#!/bin/bash
+# =============================================================================
+# Claude Code Status Line - Version complète avec emojis
+#
+# Affiche: Profil | Modèle | Git (branch ±staged/unstaged) | Projet | Contexte% | Coût | Heure
+# =============================================================================
+
+set -o pipefail
+
+# -----------------------------------------------------------------------------
+# Configuration par défaut
+# -----------------------------------------------------------------------------
+CONTEXT_WARN_THRESHOLD=60
+CONTEXT_CRIT_THRESHOLD=80
+
+# Limites d'utilisation (peuvent être surchargées par statusline.conf)
+# Valeurs par défaut pour Max 20x ($200/mois)
+SESSION_COST_LIMIT=500.00
+WEEKLY_COST_LIMIT=3000.00
+USAGE_WARN_THRESHOLD=60
+USAGE_CRIT_THRESHOLD=80
+SESSION_CACHE_TTL=60
+WEEKLY_CACHE_TTL=300
+SHOW_SESSION_LIMIT=true
+SHOW_WEEKLY_LIMIT=true
+SESSION_LABEL="⏱️ 5h"
+WEEKLY_LABEL="📅 Sem"
+
+# Charger la configuration utilisateur si elle existe
+STATUSLINE_CONF="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/statusline.conf"
+[[ -f "$STATUSLINE_CONF" ]] && source "$STATUSLINE_CONF"
+
+# Couleurs ANSI
+C_RESET='\033[00m'
+C_BOLD='\033[01m'
+C_RED='\033[01;31m'
+C_GREEN='\033[01;32m'
+C_YELLOW='\033[01;33m'
+C_BLUE='\033[01;34m'
+C_MAGENTA='\033[01;35m'
+C_CYAN='\033[01;36m'
+C_WHITE='\033[01;37m'
+C_DIM='\033[02;37m'
+
+# -----------------------------------------------------------------------------
+# Lecture du JSON en entrée (fourni par Claude Code)
+# -----------------------------------------------------------------------------
+INPUT=$(cat)
+
+# -----------------------------------------------------------------------------
+# Extraction des données depuis le JSON
+# -----------------------------------------------------------------------------
+MODEL_DISPLAY=$(echo "$INPUT" | jq -r '.model.display_name // "Unknown"')
+MODEL_ID=$(echo "$INPUT" | jq -r '.model.id // ""')
+CWD=$(echo "$INPUT" | jq -r '.workspace.current_dir // .cwd // ""')
+PROJECT_DIR=$(echo "$INPUT" | jq -r '.workspace.project_dir // ""')
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')
+SESSION_COST=$(echo "$INPUT" | jq -r '.cost.total_cost_usd // 0')
+VERSION=$(echo "$INPUT" | jq -r '.version // ""')
+
+# -----------------------------------------------------------------------------
+# 1. PROFIL ACTIF
+# -----------------------------------------------------------------------------
+get_profile() {
+    if [[ -n "$CLAUDE_CONFIG_DIR" ]]; then
+        local profile_name="${CLAUDE_CONFIG_DIR##*/}"
+        # Retire le préfixe .claude- ou claude- si présent
+        profile_name="${profile_name#.claude-}"
+        profile_name="${profile_name#claude-}"
+        echo "$profile_name"
+    else
+        echo "default"
+    fi
+}
+
+PROFILE=$(get_profile)
+
+# -----------------------------------------------------------------------------
+# 2. MODÈLE (avec emoji selon le type)
+# -----------------------------------------------------------------------------
+get_model_emoji() {
+    case "$MODEL_ID" in
+        *opus*)   echo "🧠" ;;
+        *sonnet*) echo "🎵" ;;
+        *haiku*)  echo "🍃" ;;
+        *)        echo "🤖" ;;
+    esac
+}
+
+MODEL_EMOJI=$(get_model_emoji)
+
+# -----------------------------------------------------------------------------
+# 3. GIT - Branche + Status (staged/unstaged/untracked)
+# -----------------------------------------------------------------------------
+get_git_info() {
+    local dir="${1:-$CWD}"
+    [[ -z "$dir" ]] && return
+
+    # Vérifie si c'est un repo git
+    if ! git -C "$dir" rev-parse --git-dir &>/dev/null 2>&1; then
+        return
+    fi
+
+    local branch=$(git -C "$dir" branch --show-current 2>/dev/null)
+    [[ -z "$branch" ]] && branch=$(git -C "$dir" rev-parse --short HEAD 2>/dev/null)
+    [[ -z "$branch" ]] && return
+
+    # Compte les fichiers
+    local staged=$(git -C "$dir" diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
+    local unstaged=$(git -C "$dir" diff --numstat 2>/dev/null | wc -l | tr -d ' ')
+    local untracked=$(git -C "$dir" ls-files --others --exclude-standard 2>/dev/null | wc -l | tr -d ' ')
+
+    # Construction du status
+    local status=""
+    [[ "$staged" -gt 0 ]] && status+="+${staged}"
+    [[ "$unstaged" -gt 0 ]] && status+="~${unstaged}"
+    [[ "$untracked" -gt 0 ]] && status+="?${untracked}"
+
+    if [[ -n "$status" ]]; then
+        echo "${branch} ${status}"
+    else
+        echo "$branch"
+    fi
+}
+
+GIT_INFO=$(get_git_info "$CWD")
+
+# -----------------------------------------------------------------------------
+# 4. NOM DU PROJET
+# -----------------------------------------------------------------------------
+if [[ -n "$PROJECT_DIR" ]]; then
+    PROJECT_NAME="${PROJECT_DIR##*/}"
+elif [[ -n "$CWD" ]]; then
+    PROJECT_NAME="${CWD##*/}"
+else
+    PROJECT_NAME="?"
+fi
+
+# -----------------------------------------------------------------------------
+# 5. CONTEXTE UTILISÉ (%) - Estimation via taille du transcript
+# -----------------------------------------------------------------------------
+get_context_percent() {
+    local transcript="$1"
+    [[ ! -f "$transcript" ]] && echo "" && return
+
+    # Taille du fichier transcript
+    local size=$(wc -c < "$transcript" 2>/dev/null || echo 0)
+
+    # Estimation: ~200K tokens ≈ 4MB de JSON
+    # Ajuster selon le modèle si nécessaire
+    local max_size=4000000
+    local percent=$((size * 100 / max_size))
+    [[ $percent -gt 100 ]] && percent=100
+
+    echo "$percent"
+}
+
+CONTEXT_PCT=$(get_context_percent "$TRANSCRIPT_PATH")
+
+# Couleur selon le seuil
+get_context_color() {
+    local pct="$1"
+    [[ -z "$pct" ]] && echo "$C_DIM" && return
+
+    if [[ "$pct" -ge "$CONTEXT_CRIT_THRESHOLD" ]]; then
+        echo "$C_RED"
+    elif [[ "$pct" -ge "$CONTEXT_WARN_THRESHOLD" ]]; then
+        echo "$C_YELLOW"
+    else
+        echo "$C_GREEN"
+    fi
+}
+
+CONTEXT_COLOR=$(get_context_color "$CONTEXT_PCT")
+
+# -----------------------------------------------------------------------------
+# 6. COÛT SESSION ($) - Utilise ccusage si disponible, sinon JSON
+# -----------------------------------------------------------------------------
+get_session_cost() {
+    # Priorité 1: Coût depuis le JSON (fourni par Claude Code)
+    if [[ -n "$SESSION_COST" ]] && [[ "$SESSION_COST" != "0" ]] && [[ "$SESSION_COST" != "null" ]]; then
+        printf "%.2f" "$SESSION_COST"
+        return
+    fi
+
+    # Priorité 2: ccusage si installé (session courante)
+    if command -v npx &>/dev/null; then
+        # Essaie d'obtenir le coût via ccusage statusline (mode rapide)
+        local ccusage_cost=$(timeout 2 npx --yes ccusage@latest statusline --json 2>/dev/null | jq -r '.cost // empty' 2>/dev/null)
+        if [[ -n "$ccusage_cost" ]]; then
+            printf "%.2f" "$ccusage_cost"
+            return
+        fi
+    fi
+
+    echo "0.00"
+}
+
+COST=$(get_session_cost)
+
+# -----------------------------------------------------------------------------
+# 7. USAGE SESSION (% de la limite 5h) via ccusage
+# -----------------------------------------------------------------------------
+get_usage_color() {
+    local pct="$1"
+    [[ -z "$pct" ]] && echo "$C_DIM" && return
+
+    if [[ "$pct" -ge "$USAGE_CRIT_THRESHOLD" ]]; then
+        echo "$C_RED"
+    elif [[ "$pct" -ge "$USAGE_WARN_THRESHOLD" ]]; then
+        echo "$C_YELLOW"
+    else
+        echo "$C_GREEN"
+    fi
+}
+
+get_session_usage_pct() {
+    [[ "$SHOW_SESSION_LIMIT" != "true" ]] && return
+
+    # Cache pour éviter appels répétés (ccusage est lent)
+    local cache_dir="${XDG_CACHE_HOME:-$HOME/.cache}/claude-statusline"
+    mkdir -p "$cache_dir" 2>/dev/null
+    local cache_file="$cache_dir/session_cache"
+    local now=$(date +%s)
+
+    if [[ -f "$cache_file" ]]; then
+        local cache_time=$(stat -c %Y "$cache_file" 2>/dev/null || echo 0)
+        if [[ $((now - cache_time)) -lt $SESSION_CACHE_TTL ]]; then
+            cat "$cache_file"
+            return
+        fi
+    fi
+
+    # Vérifier que npx est disponible
+    if ! command -v npx &>/dev/null; then
+        return
+    fi
+
+    local today=$(date +%Y%m%d)
+    local cost=$(timeout 5 npx --yes ccusage@latest daily --since "$today" --json 2>/dev/null | jq -r '.summary.totalCost // 0' 2>/dev/null)
+
+    if [[ -z "$cost" ]] || [[ "$cost" == "null" ]]; then
+        return
+    fi
+
+    # Calcul du pourcentage
+    local pct=$(echo "$cost $SESSION_COST_LIMIT" | awk '{if($2>0) printf "%d", ($1/$2)*100; else print 0}')
+    [[ "$pct" -gt 100 ]] && pct=100
+
+    echo "$pct" > "$cache_file"
+    echo "$pct"
+}
+
+# -----------------------------------------------------------------------------
+# 8. USAGE HEBDOMADAIRE (% de la limite semaine) via ccusage
+# -----------------------------------------------------------------------------
+get_weekly_usage_pct() {
+    [[ "$SHOW_WEEKLY_LIMIT" != "true" ]] && return
+
+    # Cache pour éviter appels répétés
+    local cache_dir="${XDG_CACHE_HOME:-$HOME/.cache}/claude-statusline"
+    mkdir -p "$cache_dir" 2>/dev/null
+    local cache_file="$cache_dir/weekly_cache"
+    local now=$(date +%s)
+
+    if [[ -f "$cache_file" ]]; then
+        local cache_time=$(stat -c %Y "$cache_file" 2>/dev/null || echo 0)
+        if [[ $((now - cache_time)) -lt $WEEKLY_CACHE_TTL ]]; then
+            cat "$cache_file"
+            return
+        fi
+    fi
+
+    # Vérifier que npx est disponible
+    if ! command -v npx &>/dev/null; then
+        return
+    fi
+
+    local week_ago=$(date -d "7 days ago" +%Y%m%d 2>/dev/null || date -v-7d +%Y%m%d 2>/dev/null)
+    [[ -z "$week_ago" ]] && return
+
+    local cost=$(timeout 8 npx --yes ccusage@latest daily --since "$week_ago" --json 2>/dev/null | jq -r '.summary.totalCost // 0' 2>/dev/null)
+
+    if [[ -z "$cost" ]] || [[ "$cost" == "null" ]]; then
+        return
+    fi
+
+    # Calcul du pourcentage
+    local pct=$(echo "$cost $WEEKLY_COST_LIMIT" | awk '{if($2>0) printf "%d", ($1/$2)*100; else print 0}')
+    [[ "$pct" -gt 100 ]] && pct=100
+
+    echo "$pct" > "$cache_file"
+    echo "$pct"
+}
+
+SESSION_USAGE_PCT=$(get_session_usage_pct)
+WEEKLY_USAGE_PCT=$(get_weekly_usage_pct)
+
+# -----------------------------------------------------------------------------
+# 9. HEURE
+# -----------------------------------------------------------------------------
+CURRENT_TIME=$(date +"%H:%M")
+
+# -----------------------------------------------------------------------------
+# CONSTRUCTION DE LA STATUS LINE
+# -----------------------------------------------------------------------------
+output=""
+
+# Profil (magenta)
+output+="${C_MAGENTA}🔑 ${PROFILE}${C_RESET}"
+
+# Modèle (cyan)
+output+=" ${C_DIM}|${C_RESET} ${C_CYAN}${MODEL_EMOJI} ${MODEL_DISPLAY}${C_RESET}"
+
+# Git (vert/jaune selon status)
+if [[ -n "$GIT_INFO" ]]; then
+    if [[ "$GIT_INFO" == *"+"* ]] || [[ "$GIT_INFO" == *"~"* ]] || [[ "$GIT_INFO" == *"?"* ]]; then
+        output+=" ${C_DIM}|${C_RESET} ${C_YELLOW}🌿 ${GIT_INFO}${C_RESET}"
+    else
+        output+=" ${C_DIM}|${C_RESET} ${C_GREEN}🌿 ${GIT_INFO}${C_RESET}"
+    fi
+fi
+
+# Projet (bleu)
+output+=" ${C_DIM}|${C_RESET} ${C_BLUE}📁 ${PROJECT_NAME}${C_RESET}"
+
+# Contexte (couleur selon seuil)
+if [[ -n "$CONTEXT_PCT" ]]; then
+    output+=" ${C_DIM}|${C_RESET} ${CONTEXT_COLOR}📊 ${CONTEXT_PCT}%${C_RESET}"
+fi
+
+# Usage session (couleur selon seuil)
+if [[ -n "$SESSION_USAGE_PCT" ]] && [[ "$SESSION_USAGE_PCT" != "0" ]]; then
+    SESSION_COLOR=$(get_usage_color "$SESSION_USAGE_PCT")
+    output+=" ${C_DIM}|${C_RESET} ${SESSION_COLOR}${SESSION_LABEL}: ${SESSION_USAGE_PCT}%${C_RESET}"
+fi
+
+# Usage hebdomadaire (couleur selon seuil)
+if [[ -n "$WEEKLY_USAGE_PCT" ]] && [[ "$WEEKLY_USAGE_PCT" != "0" ]]; then
+    WEEKLY_COLOR=$(get_usage_color "$WEEKLY_USAGE_PCT")
+    output+=" ${C_DIM}|${C_RESET} ${WEEKLY_COLOR}${WEEKLY_LABEL}: ${WEEKLY_USAGE_PCT}%${C_RESET}"
+fi
+
+# Coût (blanc)
+output+=" ${C_DIM}|${C_RESET} ${C_WHITE}💰 \$${COST}${C_RESET}"
+
+# Heure (dim)
+output+=" ${C_DIM}|${C_RESET} ${C_DIM}🕐 ${CURRENT_TIME}${C_RESET}"
+
+# Output final
+printf '%b' "$output"