🤖 Claude Session Manager

Sistema automatico per gestione sessioni di sviluppo con Claude AI

🚀 Installazione

npm install -g @antonio12761/claude-session-manager

🎯 Quick Start

# In qualsiasi progetto
cs-init

# Avvia Claude con sessione automatica
cs

✨ Caratteristiche

• 🔄 Sincronizzazione Git automatica - Pull automatico all'avvio
• 📝 Tracciamento sessioni - SESSION_STATUS.md sempre aggiornato
• 📊 Todo list integrata - Gestisci task direttamente da CLI
• 🌍 Multi-lingua - Supporto italiano e inglese
• 🔌 Estendibile - Sistema di plugin
• 📈 Report e statistiche - Monitora la tua produttività

📖 Comandi Principali

cs              # Avvia Claude con sessione automatica
cs start        # Inizia sessione manualmente
cs end          # Termina sessione con salvataggio
cs sync         # Sincronizza stato progetto

cs work "Implementato feature X"    # Traccia lavoro completato
cs todo add "Fix bug Y" --priority high  # Aggiungi TODO
cs todo list    # Mostra TODO list

cs status       # Mostra stato attuale progetto
cs report       # Genera report attività

🛠 Configurazione

Il comando cs-init crea automaticamente:

progetto/
├── SESSION_STATUS.md    # Stato sessioni
├── CLAUDE.md           # Documentazione progetto
├── .cursorrules        # Regole per Claude/Cursor
└── .claude-session.json # Configurazione locale

Personalizzazione

Modifica .claude-session.json:

{
  "projectName": "mio-progetto",
  "language": "italiano",
  "features": ["session", "todo", "reports"],
  "hooks": {
    "preStart": "npm test",
    "postEnd": "git push"
  }
}

🔧 Workflow Consigliato

Inizio Giornata

cs start  # o semplicemente 'cs' per avviare Claude

Durante il Lavoro

cs work "Completata implementazione API"
cs todo add "Scrivere test per nuovo endpoint"
cs sync  # Sincronizza con team

Fine Giornata

cs end  # Salva stato e opzionalmente committa

🌐 Integrazione con Team

Setup Team

cs team init
cs team add [email protected]

Sincronizzazione

cs team sync  # Condividi stato con il team
cs team status  # Vedi stato di tutti i membri

🔌 Plugin

Installare Plugin

cs plugin install slack-notifier
cs plugin install jira-integration

Creare Plugin

// ~/.claude-session/plugins/my-plugin.js
module.exports = {
  name: 'my-plugin',
  commands: [{
    name: 'hello',
    action: () => console.log('Hello from plugin!')
  }]
};

📊 Report e Analytics

cs report daily   # Report giornaliero
cs report weekly  # Report settimanale
cs stats          # Statistiche generali
cs export pdf     # Esporta report in PDF

🐛 Troubleshooting

Claude non si avvia

cs doctor  # Diagnostica problemi

Conflitti Git

cs repair  # Ripara stato sessione

🤝 Contribuire

1. Fork del repository
2. Crea feature branch (git checkout -b feature/AmazingFeature)
3. Commit modifiche (git commit -m 'Add AmazingFeature')
4. Push al branch (git push origin feature/AmazingFeature)
5. Apri Pull Request

📄 Licenza

Distribuito sotto licenza MIT. Vedi LICENSE per maggiori informazioni.

👤 Autore

Antonio Colaizzi

• GitHub: @antonio12761
• Email: [email protected]

🙏 Ringraziamenti

• Claude AI di Anthropic per l'ispirazione
• La community open source

⭐ Se ti piace questo progetto, lascia una stella su GitHub!