@jeremyy_prt/cc-config 1.0.0

package/commands/surveiller-ci.md

@@ -0,0 +1,65 @@
+---
+description: Surveiller et corriger automatiquement les erreurs de CI GitHub Actions
+allowed-tools: Bash(gh :*), Bash(git :*), Bash(sleep :*)
+---
+
+Tu es un outil de surveillance et correction automatique de CI. Surveille les runs GitHub Actions et corrige les erreurs jusqu'à ce que tout passe (max 3 tentatives).
+
+## Workflow
+
+1. **ATTENDRE LE DÉMARRAGE**: Laisser le temps au CI de démarrer
+   - `sleep 10` pour attendre que le workflow démarre
+   - **CRITIQUE**: Le CI met quelques secondes à apparaître après un push
+
+2. **SURVEILLER LE RUN**: Observer le pipeline en temps réel
+   - `gh run list --limit 1` pour obtenir l'ID du dernier run
+   - `gh run watch <run-id>` pour surveiller en direct
+   - **ATTENDRE**: Que le run se termine (succès ou échec)
+
+3. **SI SUCCÈS**: Nettoyer et terminer
+   - Supprimer les artifacts téléchargés s'il y en a
+   - Afficher le statut final avec `gh run view <run-id>`
+   - **STOP**: Mission accomplie
+
+4. **SI ÉCHEC**: Analyser et corriger (max 3 tentatives)
+   - `gh run view <run-id> --log-failed` pour récupérer les logs d'erreur
+   - Analyser les erreurs pour identifier la cause racine
+   - Faire les corrections ciblées dans le code
+   - Commit avec message descriptif: `fix(ci): [ce qui a été corrigé]`
+   - `git push` pour déclencher un nouveau run
+   - **INCRÉMENTER**: Le compteur de tentatives
+   - **BOUCLER**: Retourner à l'étape 1 (sauf si 3 tentatives atteintes)
+
+5. **SI 3 ÉCHECS**: Rapporter et arrêter
+   - Afficher un résumé des 3 tentatives et erreurs
+   - **STOP**: L'intervention humaine est nécessaire
+
+## Règles d'Exécution
+
+- **MAX 3 TENTATIVES**: Éviter les boucles infinies
+- **CORRECTIONS CIBLÉES**: Corriger uniquement les erreurs CI, pas de refactoring
+- **MESSAGES DESCRIPTIFS**: Chaque commit doit expliquer la correction
+- **VÉRIFIER AVANT DE PUSH**: S'assurer que la correction a du sens
+- **FOCUS CI**: Rester concentré sur les erreurs de pipeline uniquement
+
+## Exemples de Messages de Commit
+
+```
+fix(ci): install missing dependency @types/node
+fix(ci): update node version to 18 in workflow
+fix(ci): fix eslint errors in api routes
+fix(ci): add missing env variables for tests
+```
+
+## Outils Autorisés
+
+- `gh run list` - Lister les runs
+- `gh run watch <id>` - Surveiller un run
+- `gh run view <id>` - Voir les détails d'un run
+- `gh run view <id> --log-failed` - Logs des échecs
+- `git add`, `git commit`, `git push` - Corrections
+- `sleep` - Attendre le démarrage du CI
+
+## Priorité
+
+Précision des corrections > Vitesse. Bien comprendre l'erreur avant de corriger.

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@jeremyy_prt/cc-config",
+  "version": "1.0.0",
+  "description": "Configuration personnalisée pour Claude Code avec commandes et agents en français",
+  "main": "index.js",
+  "bin": {
+    "cc-config": "cli.js"
+  },
+  "scripts": {
+    "setup": "node cli.js setup"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "config",
+    "français",
+    "commands",
+    "agents",
+    "jeremy",
+    "productivity"
+  ],
+  "author": "Jeremy (@jeremyy_prt)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeremy-prt/cc-config.git"
+  },
+  "homepage": "https://github.com/jeremy-prt/cc-config#readme",
+  "bugs": {
+    "url": "https://github.com/jeremy-prt/cc-config/issues"
+  },
+  "files": [
+    "commands/",
+    "agents/",
+    "scripts/",
+    "song/",
+    "settings.json",
+    "cli.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/scripts/statusline/CLAUDE.md

@@ -0,0 +1,178 @@
+# Claude Code Statusline - Project Memory
+
+## Overview
+
+Clean, type-safe statusline implementation for Claude Code using Bun + TypeScript. Displays real-time session information, git status, context usage, and Claude API rate limits.
+
+## Project Setup & Configuration
+
+### Dependencies
+- **Bun**: Runtime (uses `$` for shell commands)
+- **@biomejs/biome**: Linting & formatting
+- **TypeScript**: Type safety
+
+No external npm packages required - pure Bun APIs.
+
+### Configuration in Claude Code
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bun /Users/melvynx/.claude/scripts/statusline/src/index.ts",
+    "padding": 0
+  }
+}
+```
+
+### Authentication
+
+OAuth token stored in macOS Keychain:
+- **Service**: `Claude Code-credentials`
+- **Format**: JSON with `claudeAiOauth.accessToken`
+- **Token type**: `sk-ant-oat01-...` (OAuth token, not API key)
+- **Access**: `security find-generic-password -s "Claude Code-credentials" -w`
+
+## Architecture
+
+### Modular Design
+
+The project follows a clean architecture with separated concerns:
+
+```
+src/
+├── index.ts              # Main entry - orchestrates all components
+└── lib/
+    ├── types.ts          # TypeScript interfaces (HookInput)
+    ├── git.ts            # Git operations (branch, changes)
+    ├── context.ts        # Transcript parsing & context calculation
+    ├── usage-limits.ts   # Claude OAuth API integration
+    └── formatters.ts     # Display utilities & colors
+```
+
+### Data Flow
+
+```
+Claude Code Hook → stdin JSON → index.ts
+                                    ↓
+                    ┌───────────────┴───────────────┐
+                    ↓                               ↓
+            [Get Git Status]            [Get Context Data]
+                    ↓                               ↓
+            [Format Branch]             [Get Usage Limits]
+                    ↓                               ↓
+                    └───────────────┬───────────────┘
+                                    ↓
+                            [Build Output Lines]
+                                    ↓
+                            stdout (2 lines)
+```
+
+## Component Specifications
+
+### Context Calculation (`lib/context.ts`)
+- **Purpose**: Calculate token usage from Claude Code transcript files
+- **Algorithm**: Parses `.jsonl` transcript, finds most recent main-chain entry
+- **Tokens counted**: `input_tokens + cache_read_input_tokens + cache_creation_input_tokens`
+- **Excludes**: Sidechain entries (agent calls), API error messages
+- **Output**: `{ tokens: number, percentage: number }` (0-100% of 200k context)
+
+### Usage Limits (`lib/usage-limits.ts`)
+- **Purpose**: Fetch Claude API rate limits from OAuth endpoint
+- **Auth**: Retrieves OAuth token from macOS Keychain (`Claude Code-credentials`)
+- **API**: `https://api.anthropic.com/api/oauth/usage`
+- **Data**: Five-hour window utilization + reset time
+- **Error handling**: Fails silently, returns null on errors
+
+### Git Status (`lib/git.ts`)
+- **Purpose**: Show current branch and uncommitted changes
+- **Detection**: Checks both staged and unstaged changes
+- **Output**: Branch name + line additions/deletions
+- **Display**: `main* (+123 -45)` with color coding
+
+### Formatters (`lib/formatters.ts`)
+- **Colors**: ANSI color codes for terminal output
+- **Token display**: `62.5K`, `1.2M` format
+- **Time formatting**: `3h21m`, `45m` for countdowns
+- **Reset time**: Calculates difference between API reset time and now
+
+## Output Specification
+
+### Line 1: Session Info
+```
+main* (+123 -45) | ~/.claude | Sonnet 4.5
+```
+
+### Line 2: Metrics
+```
+$0.17 (6m) | 62.5K tokens | 31% | 15% (3h27m)
+```
+
+**Components:**
+- `$0.17` - Session cost (USD)
+- `(6m)` - Session duration
+- `62.5K tokens` - Context tokens used (from transcript)
+- `31%` - Context percentage (tokens / 200k)
+- `15%` - Five-hour usage (from Claude API)
+- `(3h27m)` - Time until rate limit resets
+
+## Development
+
+### Testing
+
+```bash
+# Run test with fixture
+bun run test
+
+# Use custom fixture
+bun run test fixtures/custom.json
+
+# Manual test
+echo '{ ... }' | bun run start
+```
+
+### Code Conventions
+
+- **ALWAYS** use camelCase for variables and functions
+- Use TypeScript strict mode
+- Follow Biome formatting rules
+
+### Error Handling & Performance
+
+**Error Handling** - All components fail silently:
+- Missing transcript → 0 tokens, 0%
+- API failure → No usage limits shown
+- Git errors → "no-git" branch
+- Keychain access denied → No usage limits
+
+This ensures statusline never crashes Claude Code.
+
+**Performance Benchmarks:**
+- Context calculation: ~10-50ms (depends on transcript size)
+- API call: ~100-300ms (cached by Claude API)
+- Git operations: ~20-50ms
+- Total: < 500ms typical
+
+## Maintenance Guide
+
+### Adding New Metrics
+
+1. Add interface to `lib/types.ts`
+2. Create fetcher in `lib/*.ts`
+3. Import in `index.ts`
+4. Add to `buildSecondLine()`
+
+### Modifying Display
+
+- Colors: Edit `lib/formatters.ts` colors constant
+- Layout: Modify `buildFirstLine()` / `buildSecondLine()`
+- Formatting: Add functions to `lib/formatters.ts`
+
+## Known Limitations
+
+- macOS only (uses Keychain)
+- Requires `git` CLI for git status
+- Requires Claude Code OAuth (not API key)
+- Transcript must be accessible (permissions)

package/scripts/statusline/README.md

@@ -0,0 +1,105 @@
+# Claude Code Statusline
+
+Clean, modular statusline for Claude Code with TypeScript + Bun.
+
+## Features
+
+- 🌿 Git branch with changes (+added -deleted)
+- 💰 Session cost and duration
+- 🧩 Context tokens used
+- 📊 Context percentage (0-100%)
+- ⏱️ Five-hour usage limit with reset time
+
+## Structure
+
+```
+src/
+├── index.ts              # Main entry point
+└── lib/
+    ├── types.ts          # TypeScript interfaces
+    ├── git.ts            # Git status
+    ├── context.ts        # Context calculation from transcript
+    ├── usage-limits.ts   # Claude API usage limits
+    └── formatters.ts     # Formatting utilities
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run the statusline (needs stdin JSON)
+echo '{ ... }' | bun run start
+
+# View today's spending
+bun run spend:today
+
+# View this month's spending
+bun run spend:month
+
+# Format code
+bun run format
+
+# Lint code
+bun run lint
+```
+
+## Spend Tracking
+
+The statusline automatically saves session data to `data/spend.json`. You can view your spending with:
+
+```bash
+# Today's sessions and cost
+bun run spend:today
+
+# This month's sessions grouped by date
+bun run spend:month
+```
+
+Each session tracks:
+- Cost (USD)
+- Duration
+- Lines added/removed
+- Working directory
+
+## Usage in Claude Code
+
+Update your `~/.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bun /Users/melvynx/.claude/scripts/statusline/src/index.ts",
+    "padding": 0
+  }
+}
+```
+
+## Testing
+
+```bash
+echo '{
+  "session_id": "test",
+  "transcript_path": "/path/to/transcript.jsonl",
+  "cwd": "/path",
+  "model": {
+    "id": "claude-sonnet-4-5",
+    "display_name": "Sonnet 4.5"
+  },
+  "workspace": {
+    "current_dir": "/path",
+    "project_dir": "/path"
+  },
+  "version": "2.0.31",
+  "output_style": { "name": "default" },
+  "cost": {
+    "total_cost_usd": 0.15,
+    "total_duration_ms": 300000,
+    "total_api_duration_ms": 200000,
+    "total_lines_added": 100,
+    "total_lines_removed": 50
+  }
+}' | bun run start
+```

package/scripts/statusline/biome.json

@@ -0,0 +1,34 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.3.2/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab"
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}

package/scripts/statusline/data/.gitignore

@@ -0,0 +1,5 @@
+# Ignore all data and cache files
+*.json
+
+# But keep this .gitignore
+!.gitignore

package/scripts/statusline/fixtures/test-input.json

@@ -0,0 +1,25 @@
+{
+	"session_id": "06a7b019-03f8-4083-a9db-410d95cb01e6",
+	"transcript_path": "/Users/melvynx/.claude/projects/-Users-melvynx--claude/06a7b019-03f8-4083-a9db-410d95cb01e6.jsonl",
+	"cwd": "/Users/melvynx/.claude",
+	"model": {
+		"id": "claude-sonnet-4-5-20250929",
+		"display_name": "Sonnet 4.5"
+	},
+	"workspace": {
+		"current_dir": "/Users/melvynx/.claude",
+		"project_dir": "/Users/melvynx/.claude"
+	},
+	"version": "2.0.31",
+	"output_style": {
+		"name": "default"
+	},
+	"cost": {
+		"total_cost_usd": 0.17468000000000003,
+		"total_duration_ms": 385160,
+		"total_api_duration_ms": 252694,
+		"total_lines_added": 185,
+		"total_lines_removed": 75
+	},
+	"exceeds_200k_tokens": false
+}

package/scripts/statusline/package.json

@@ -0,0 +1,21 @@
+{
+	"name": "statusline",
+	"version": "1.0.0",
+	"module": "src/index.ts",
+	"type": "module",
+	"scripts": {
+		"start": "bun run src/index.ts",
+		"test": "bun run test.ts",
+		"spend:today": "bun run src/commands/spend-today.ts",
+		"spend:month": "bun run src/commands/spend-month.ts",
+		"lint": "biome check --write .",
+		"format": "biome format --write ."
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.2",
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5.0.0"
+	}
+}

package/scripts/statusline/src/commands/CLAUDE.md

@@ -0,0 +1,3 @@
+Important :
+
+This folder only include command that we can run using `/Users/melvynx/.claude/scripts/statusline/package.json` commands. Please don't write anything else here.

package/scripts/statusline/src/commands/spend-month.ts

@@ -0,0 +1,60 @@
+#!/usr/bin/env bun
+
+import { formatCost, formatDuration } from "../lib/formatters";
+import {
+	calculateTotalCost,
+	calculateTotalDuration,
+	filterSessionsByDate,
+	getMonthStart,
+	loadSpendData,
+} from "../lib/spend";
+
+async function main() {
+	const data = await loadSpendData();
+	const monthStart = getMonthStart();
+	const monthSessions = filterSessionsByDate(data.sessions, monthStart);
+
+	if (monthSessions.length === 0) {
+		console.log("📊 No sessions this month");
+		return;
+	}
+
+	const totalCost = calculateTotalCost(monthSessions);
+	const totalDuration = calculateTotalDuration(monthSessions);
+
+	// Group by date
+	const sessionsByDate = monthSessions.reduce(
+		(acc, session) => {
+			if (!acc[session.date]) {
+				acc[session.date] = [];
+			}
+			acc[session.date].push(session);
+			return acc;
+		},
+		{} as Record<string, typeof monthSessions>,
+	);
+
+	const monthName = monthStart.toLocaleString("default", { month: "long" });
+
+	console.log(`\n📊 ${monthName}'s Spend\n`);
+	console.log(`Sessions: ${monthSessions.length}`);
+	console.log(`Total Cost: $${formatCost(totalCost)}`);
+	console.log(`Total Duration: ${formatDuration(totalDuration)}`);
+	console.log(`\n📅 By Date:\n`);
+
+	const sortedDates = Object.keys(sessionsByDate).sort();
+
+	for (const date of sortedDates) {
+		const sessions = sessionsByDate[date];
+		const dayCost = calculateTotalCost(sessions);
+		const dayDuration = calculateTotalDuration(sessions);
+
+		console.log(
+			`  ${date}: $${formatCost(dayCost)} (${formatDuration(dayDuration)}) - ${sessions.length} session(s)`,
+		);
+	}
+
+	console.log("");
+}
+
+main();

package/scripts/statusline/src/commands/spend-today.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env bun
+
+import { formatCost, formatDuration } from "../lib/formatters";
+import {
+	calculateTotalCost,
+	calculateTotalDuration,
+	filterSessionsByDate,
+	getTodayStart,
+	loadSpendData,
+} from "../lib/spend";
+
+async function main() {
+	const data = await loadSpendData();
+	const today = getTodayStart();
+	const todaySessions = filterSessionsByDate(data.sessions, today);
+
+	if (todaySessions.length === 0) {
+		console.log("📊 No sessions today");
+		return;
+	}
+
+	const totalCost = calculateTotalCost(todaySessions);
+	const totalDuration = calculateTotalDuration(todaySessions);
+
+	console.log(`\n📊 Today's Spend\n`);
+	console.log(`Sessions: ${todaySessions.length}`);
+	console.log(`Total Cost: $${formatCost(totalCost)}`);
+	console.log(`Total Duration: ${formatDuration(totalDuration)}`);
+	console.log(`\n📝 Sessions:\n`);
+
+	for (const session of todaySessions) {
+		console.log(
+			`  • $${formatCost(session.cost)} (${formatDuration(session.duration_ms)})`,
+		);
+		console.log(`    ${session.cwd}`);
+		console.log(
+			`    +${session.lines_added} -${session.lines_removed} lines\n`,
+		);
+	}
+}
+
+main();