🚀 Work Tracker Universal

Sistema completo di tracking per progetti di sviluppo con integrazione Claude AI

📋 Indice

Caratteristiche
Progetti Supportati
Installazione
Utilizzo
Integrazione Claude
Comandi Disponibili
Configurazione
Esempi
Troubleshooting

✨ Caratteristiche

🎯 Auto-detection: Rileva automaticamente il tipo di progetto
📝 Session tracking: Traccia automaticamente ogni sessione di lavoro
🤖 Claude integration: Prepara contesto ottimale per Claude AI
🔨 Build automation: Comandi build/test/run specifici per progetto
💾 Smart backup: Backup automatici con esclusione directory build
📊 Statistics: Statistiche dettagliate su progresso e commit
🌍 Universal: Funziona con qualsiasi progetto di sviluppo
⚡ Fast setup: Installazione in 30 secondi

🛠️ Progetti Supportati

Linguaggio/Framework	File di riconoscimento	Build Command	Test Command
Node.js/JavaScript	`package.json`	`npm install && npm run build`	`npm test`
PHP	`composer.json`	`composer install`	`vendor/bin/phpunit`
Python	`requirements.txt`, `pyproject.toml`	`pip install -r requirements.txt`	`pytest`
Pascal/Lazarus	`.lpi`, `.pas`	`lazarus-ide --build-mode=default *.lpi`	-
Rust	`Cargo.toml`	`cargo build`	`cargo test`
Go	`go.mod`	`go build`	`go test ./...`
Java	`pom.xml`, `build.gradle`	`mvn compile`	`mvn test`
C++	`CMakeLists.txt`, `Makefile`	`make`	`make test`
C#	`.sln`, `.csproj`	`dotnet build`	`dotnet test`
Generic	Qualsiasi progetto	Configurabile	Configurabile

📦 Installazione

Installazione Automatica (Raccomandato)

# Clona il repository
git clone https://github.com/user/work-tracker-universal.git
cd work-tracker-universal

# Esegui installer
./install.sh

# Riavvia terminale o ricarica bashrc
source ~/.bashrc

Installazione Manuale

# Copia script in directory PATH
cp work-tracker ~/.local/bin/
chmod +x ~/.local/bin/work-tracker

# Aggiungi al PATH se necessario
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
source ~/.bashrc

Verifica Installazione

work-tracker version
work-tracker help

🚀 Utilizzo

1. Setup Progetto (Prima Volta)

# Vai nella directory del progetto
cd /path/to/your/project

# Inizializza work-tracker (auto-rileva tipo progetto)
work-tracker init

2. Workflow Giornaliero

# 🌅 Inizio giornata
work-tracker start    # oppure: ws

# 💼 Durante il lavoro
work-tracker status   # oppure: wst
work-tracker build    # oppure: wbuild
work-tracker test     # oppure: wtest

# 🌆 Fine giornata
work-tracker end      # oppure: we

3. Integrazione con Claude

# Prepara contesto per Claude
work-tracker claude   # oppure: wclaude

# Copia e incolla il prompt suggerito in Claude

🤖 Integrazione Claude

Work Tracker genera automaticamente il contesto perfetto per Claude:

Prompt Ottimale Generato

Ciao! Sto lavorando sul progetto MyApp (tipo: nodejs).

Per favore leggi prima:
1. .work-tracker/latest_session.md (stato lavoro corrente)
2. README.md (documentazione progetto)
3. package.json (configurazione Node.js)

Sono pronto per continuare il development!

File di Contesto Creati

.work-tracker/session_YYYY-MM-DD.md - Sessione giornaliera
.work-tracker/latest_session.md - Link alla sessione più recente
.work-tracker/claude_context_YYYY-MM-DD.md - Contesto completo per Claude

📚 Comandi Disponibili

Comandi Core

Comando	Alias	Descrizione
`work-tracker init`	-	Inizializza progetto
`work-tracker start`	`ws`	Inizia sessione
`work-tracker end`	`we`	Termina sessione
`work-tracker status`	`wst`	Stato corrente
`work-tracker claude`	`wclaude`	Contesto per Claude

Comandi Development

Comando	Alias	Descrizione
`work-tracker build`	`wbuild`	Build progetto
`work-tracker test`	`wtest`	Esegui test
`work-tracker run`	`wrun`	Esegui progetto
`work-tracker logs`	`wlogs`	Mostra log

Utilità

Comando	Alias	Descrizione
`work-tracker backup`	`wbackup`	Crea backup
`work-tracker config`	`wconfig`	Mostra config
`work-tracker summary`	`wsum`	Riepilogo auto

Funzioni Avanzate

# Avvio rapido con obiettivo
wquick "Implementare feature X"

# Aggiungi nota alla sessione corrente
wnote "Fix completato per bug #123"

# Segnala problema
wproblem "SIGSEGV nel modulo Y"

# Mostra tutti gli alias
whelp

⚙️ Configurazione

File di Configurazione

Ogni progetto ha la sua configurazione in .work-tracker/config.conf:

# Work Tracker Configuration
PROJECT_NAME="MyApp"
PROJECT_TYPE="nodejs"
BUILD_COMMAND="npm install && npm run build"
TEST_COMMAND="npm test"
RUN_COMMAND="npm start"
LOG_FILE="logs/*.log"
MAIN_FILES="*.js,*.ts,*.json,src/**/*"

# Custom settings
AUTO_COMMIT=false
AUTO_BACKUP=true
CLAUDE_INTEGRATION=true

Personalizzazione Comandi

Modifica il file di configurazione per personalizzare i comandi:

# Apri configurazione
work-tracker config

# Modifica direttamente
nano .work-tracker/config.conf

Template Personalizzati

Puoi personalizzare i template di sessione modificando lo script principale.

📖 Esempi

Esempio 1: Progetto Node.js

cd my-node-app
work-tracker init          # Auto-rileva: nodejs
work-tracker start         # Crea sessione
work-tracker build         # npm install && npm run build
work-tracker test          # npm test
work-tracker claude        # Prepara contesto
work-tracker end           # Termina con riepilogo

Esempio 2: Progetto Python

cd my-python-project
work-tracker init          # Auto-rileva: python
ws                         # Avvia sessione (alias)
wbuild                     # pip install -r requirements.txt
wtest                      # pytest
wnote "Aggiunte nuove funzionalità"
wclaude                    # Contesto per Claude
we                         # Termina sessione

Esempio 3: Progetto Pascal/Lazarus

cd my-pascal-app
work-tracker init          # Auto-rileva: pascal
work-tracker start
work-tracker build         # lazarus-ide --build-mode=default *.lpi
work-tracker logs          # tail -f logs/*.log
work-tracker backup        # Backup automatico
work-tracker claude
work-tracker end

🔧 Troubleshooting

Problemi Comuni

1. Command not found

# Verifica PATH
echo $PATH | grep -o '[^:]*bin'

# Aggiungi al PATH
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
source ~/.bashrc

2. Progetto non riconosciuto

# Forza tipo progetto
echo 'PROJECT_TYPE="nodejs"' >> .work-tracker/config.conf

# Oppure re-inizializza
rm -rf .work-tracker
work-tracker init

3. Build command non funziona

# Verifica configurazione
work-tracker config

# Modifica comando
nano .work-tracker/config.conf
# Cambia: BUILD_COMMAND="tuo-comando-personalizzato"

4. Alias non funzionano

# Ricarica aliases
source ~/.bashrc

# Verifica se sono caricati
whelp

Debugging

# Abilita debug mode
export WORK_TRACKER_DEBUG=1

# Mostra file di configurazione
cat .work-tracker/config.conf

# Controlla log di sistema
journalctl --user -u work-tracker

Disinstallazione

# Disinstallazione automatica
./install.sh uninstall

# Rimozione manuale
rm ~/.local/bin/work-tracker
rm ~/.work-tracker-aliases
# Rimuovi manualmente da ~/.bashrc le righe work-tracker

🚧 Roadmap

Plugin system per estensioni personalizzate
Web dashboard per visualizzazione statistiche
Team collaboration per progetti condivisi
AI suggestions basate su pattern di lavoro
IDE integration per VS Code, IntelliJ, etc.
Docker support per progetti containerizzati
Cloud sync per backup automatici

🤝 Contribuire

Fork del repository
Crea branch feature (git checkout -b feature/nuova-funzionalita)
Commit modifiche (git commit -am 'Aggiunge nuova funzionalità')
Push al branch (git push origin feature/nuova-funzionalita)
Apri Pull Request

📄 Licenza

MIT License - vedi file LICENSE per dettagli.

🙏 Crediti

Sviluppato con ❤️ per massimizzare l'efficienza con Claude AI
Ispirato dalle migliori pratiche di development workflow
Testato su progetti reali di produzione

⭐ Se work-tracker ti è utile, lascia una stella su GitHub!

💬 Domande? Apri una issue o contatta @username

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
.github		.github
.gitignore		.gitignore
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
demo.sh		demo.sh
install.sh		install.sh
work-tracker		work-tracker

License

edpmatrix/work-tracker-universal

Folders and files

Latest commit

History

Repository files navigation