21 - Monitoraggio e Produttività con Claude Code

# Installazione
npm install -g ccflare

# Avvio della Web UI
ccflare serve

# La UI e disponibile su http://localhost:3847
# Apri il browser e naviga all'indirizzo

# Opzioni di configurazione
ccflare serve --port 8080           # Porta personalizzata
ccflare serve --data ~/.claude/     # Directory dati personalizzata

# Installazione del fork migliorato
npm install -g better-ccflare

# Avvio con tutte le funzionalità
better-ccflare serve

# Export dati per analisi esterna
better-ccflare export --format csv --from 2026-01-01 --to 2026-01-31
# Output: usage-2026-01.csv

# Impostazione alert di consumo
better-ccflare alert --daily-limit 50000 --notify email
# Ricevi una notifica quando superi 50,000 token/giorno

# Confronto tra periodi
better-ccflare compare --this-week --last-week
# Output:
# Token Usage: +15% (this week: 245,000 vs last week: 213,000)
# Sessions: -2 (this week: 18 vs last week: 20)
# Avg tokens/session: +23% (this week: 13,611 vs last week: 10,650)
# Estimated cost: +12% ($4.90 vs $4.26)

# Installazione
npm install -g cc-usage

# Mostra utilizzo dell'ultima sessione
cc-usage last
# Session: sess_abc123
# Duration: 45 minutes
# Input tokens: 23,456
# Output tokens: 8,901
# Total tokens: 32,357
# Estimated cost: $0.65

# Mostra utilizzo giornaliero
cc-usage today
# Today's usage:
# Sessions: 5
# Total tokens: 156,789
# Estimated cost: $3.14

# Mostra utilizzo settimanale con grafico ASCII
cc-usage week --chart
# Mon: ████████████████ 45,234
# Tue: ██████████████████████ 62,100
# Wed: ████████████ 35,678
# Thu: ██████████████████ 51,234
# Fri: ████████████████████ 56,789
# Sat: ████ 12,345
# Sun: ██ 6,789
# Total: 269,169 tokens (~$5.38)

# Mostra utilizzo mensile con breakdown per progetto
cc-usage month --by-project
# Project: portfolio-angular    89,234 tokens (33%)
# Project: play-the-event      134,567 tokens (50%)
# Project: tech-mcp             45,678 tokens (17%)
# Total: 269,479 tokens (~$5.39)

# Installazione
npm install -g claudex

# Avvia il browser delle conversazioni
claudex browse

# Cerca in tutte le conversazioni
claudex search "come configurare nginx"
# Found 3 conversations:
# 1. [2026-01-15] Session about nginx reverse proxy setup
# 2. [2026-01-22] Debugging nginx SSL certificate
# 3. [2026-02-01] Nginx load balancer configuration

# Mostra i dettagli di una conversazione specifica
claudex show sess_abc123

# Esporta una conversazione come markdown
claudex export sess_abc123 --format markdown --output session-recap.md

# Statistiche sulle conversazioni
claudex stats
# Total conversations: 156
# Date range: 2025-11-01 to 2026-02-14
# Most active project: play-the-event (67 conversations)
# Average conversation length: 23 turns
# Most used tools: Write (345), Bash (234), Read (567)

# Installazione
npm install -g cc-sessions

# Crea una nuova sessione con tag
cc-sessions new --project my-app --tag "feature/user-auth" --description "Implementazione sistema di autenticazione"

# Lista sessioni attive
cc-sessions list
# ID          | Project    | Tag                | Status  | Last Active
# sess_001    | my-app     | feature/user-auth  | active  | 5 min ago
# sess_002    | my-app     | bugfix/login       | paused  | 2 hours ago
# sess_003    | portfolio  | blog-articles      | active  | 1 hour ago

# Riprendi una sessione con contesto
cc-sessions resume sess_002
# Restoring context for session sess_002...
# Project: my-app
# Branch: bugfix/login
# Last activity: Fixed login timeout, working on session management
# Files modified: LoginService.java, SessionConfig.java

# Salva lo stato della sessione corrente
cc-sessions save --note "Completato endpoint login, prossimo step: refresh token"

# Cerca sessioni per contenuto
cc-sessions search "nginx configuration"
# Found in sessions: sess_015, sess_023

# Archivia sessioni completate
cc-sessions archive sess_001 --reason "Feature completata e mergiata"

# Il checkpointing è automatico in Claude Code
# Ogni modifica ai file viene tracciata

# Nella sessione Claude Code, puoi usare:
# /undo - Annulla l'ultima modifica
# /undo 3 - Annulla le ultime 3 modifiche

# Esempio di workflow con checkpoint:
# 1. Claude modifica UserService.java
# 2. Claude modifica UserController.java
# 3. Claude modifica UserDTO.java
# 4. Test fallisce: il DTO ha un problema

# Puoi annullare solo la modifica al DTO:
# /undo 1
# Questo ripristina UserDTO.java senza toccare gli altri file

# Per vedere lo storico delle modifiche nella sessione:
# /diff
# Output:
# [1] UserService.java: +15 -3 lines (10:23:45)
# [2] UserController.java: +8 -2 lines (10:25:12)
# [3] UserDTO.java: +5 -1 lines (10:26:30)  <-- annullabile

# Per annullare una modifica specifica:
# /undo --file UserDTO.java
# Ripristina solo quel file allo stato pre-modifica

# Installazione
npm install -g claudekit

# Lista dei sub-agenti disponibili
claudekit list
# Available agents (22):
#
# Development:
#   scaffold    - Generate project scaffolding
#   component   - Create new components with tests
#   api         - Generate REST API endpoints
#   migration   - Create database migrations
#
# Quality:
#   review      - AI-powered code review
#   test        - Generate comprehensive tests
#   lint-fix    - Fix linting issues automatically
#   refactor    - Suggest and apply refactoring
#
# Documentation:
#   docs        - Generate documentation
#   readme      - Create/update README
#   changelog   - Generate changelog from commits
#   adr         - Create Architecture Decision Records
#
# DevOps:
#   docker      - Generate Dockerfile and compose
#   ci          - Create CI/CD pipelines
#   deploy      - Deployment scripts and configs
#
# Analysis:
#   audit       - Security audit of codebase
#   deps        - Dependency analysis and updates
#   perf        - Performance analysis
#   complexity  - Code complexity metrics
#
# Utilities:
#   git-msg     - Generate commit messages
#   pr          - Create pull request descriptions
#   issue       - Generate issue templates

# Code Review automatica
claudekit review src/app/services/order.service.ts
# Review Report:
# Severity: 2 high, 5 medium, 3 low
#
# [HIGH] Line 45: SQL query built with string concatenation
#   Recommendation: Use parameterized query to prevent SQL injection
#
# [HIGH] Line 78: Sensitive data logged without masking
#   Recommendation: Mask PII in log output
#
# [MEDIUM] Line 23: Method exceeds 50 lines (67 lines)
#   Recommendation: Extract sub-methods for readability
# ...

# Generazione test automatica
claudekit test src/app/services/user.service.ts
# Generated 12 test cases:
#   - createUser_validInput_returnsUser
#   - createUser_duplicateEmail_throwsException
#   - createUser_invalidEmail_throwsValidation
#   - findById_existingUser_returnsUser
#   - findById_nonExistent_throwsNotFound
#   - updateUser_validChanges_returnsUpdated
#   - updateUser_emailConflict_throwsException
#   - deleteUser_existingUser_returnsSuccess
#   - deleteUser_nonExistent_throwsNotFound
#   - listUsers_withPagination_returnsPaged
#   - listUsers_withFilter_returnsFiltered
#   - listUsers_emptyResult_returnsEmpty

# Analisi di complessità
claudekit complexity src/
# Complexity Report:
# File                              | Cyclomatic | Lines | Rating
# ----------------------------------|------------|-------|-------
# order.service.ts                  | 23         | 450   | D
# payment.service.ts                | 18         | 320   | C
# user.service.ts                   | 12         | 180   | B
# notification.service.ts           | 8          | 120   | A
# ...
# Average complexity: 15.2 (C)
# Recommendation: Refactor order.service.ts (complexity > 20)

# Generazione changelog
claudekit changelog --from v1.2.0 --to HEAD
# # Changelog v1.3.0
#
# ## Features
# - Add recurring orders functionality (#145)
# - Implement email notification templates (#148)
# - Add export to CSV for reports (#152)
#
# ## Bug Fixes
# - Fix login timeout on slow connections (#143)
# - Resolve pagination issue in order list (#147)
#
# ## Improvements
# - Optimize database queries for order search (#150)
# - Update dependencies to latest versions (#151)

# Installazione
cargo install ccometixline

# Configurazione nel .bashrc o .zshrc
eval "$(ccometixline init bash)"  # Per Bash
eval "$(ccometixline init zsh)"   # Per Zsh

# Output nel prompt:
# [claude:opus-4|12.5k tokens|$0.25] main* ~/my-project $

# Personalizzazione
# ~/.config/ccometixline/config.toml
[display]
show_model = true
show_tokens = true
show_cost = true
show_git_branch = true
show_session_duration = true

[colors]
model = "cyan"
tokens = "yellow"
cost = "green"
git = "magenta"
duration = "white"

[thresholds]
token_warning = 50000     # Giallo sopra 50k token
token_danger = 100000     # Rosso sopra 100k token
cost_warning = 2.00       # Giallo sopra $2
cost_danger = 5.00        # Rosso sopra $5

#!/bin/bash
# daily-productivity-report.sh
# Genera un report di produttività giornaliero

echo "=== Claude Code Productivity Report ==="
echo "Date: $(date +%Y-%m-%d)"
echo ""

# 1. Utilizzo token del giorno
echo "--- Token Usage ---"
cc-usage today
echo ""

# 2. Sessioni del giorno
echo "--- Sessions ---"
cc-sessions list --today
echo ""

# 3. File modificati con Claude Code oggi
echo "--- Files Changed ---"
git log --since="today" --name-only --pretty=format: | sort -u | head -20
echo ""

# 4. Commits assistiti da AI
echo "--- AI-Assisted Commits ---"
git log --since="today" --oneline | wc -l
echo "commits today"
echo ""

# 5. Test generati
echo "--- Tests Generated ---"
git log --since="today" --name-only --pretty=format: | grep -c "\.spec\.\|\.test\.\|Test\.java"
echo "test files created/modified"
echo ""

# 6. Stima risparmio tempo
echo "--- Time Savings Estimate ---"
COMMITS=$(git log --since="today" --oneline | wc -l)
FILES=$(git log --since="today" --name-only --pretty=format: | sort -u | wc -l)
TESTS=$(git log --since="today" --name-only --pretty=format: | grep -c "\.spec\.\|\.test\.\|Test\.java")

# Stima conservativa: 20 min risparmiati per file, 30 min per test
SAVED_MINUTES=$(( (FILES * 20) + (TESTS * 30) ))
echo "Estimated time saved: ${SAVED_MINUTES} minutes (~$(( SAVED_MINUTES / 60 )) hours)"
echo ""

# 7. Costo stimato
echo "--- Estimated Cost ---"
cc-usage today --cost-only
echo ""

echo "=== End of Report ==="