Chronix

Spazio di lavoro collaborativo self‑hosted per pentester e operatori red team. Cattura note, comandi, output e contesto operativo durante gli engagement di sicurezza.

Avvio Rapido

# Installa
pipx install git+https://github.com/IceCubeSandwich/chronix

# Inizializza (crea account e segreto di sessione)
chronix init

# Esegui
chronix

Il browser si apre su http://localhost:8000. Le credenziali vengono mostrate una volta durante l'inizializzazione: conservale in modo sicuro.

Funzionalità

• Registrazione Timeline: voci con timestamp con campi fonte, destinazione, strumento, comando, output e risultato
• Note Collaborative: pagine Markdown con salvataggio automatico e cronologia delle versioni
• Sincronizzazione in Tempo Reale: aggiornamenti WebSocket tra sessioni concorrenti
• Filtra e Cerca: filtra la timeline per strumento, destinazione o testo
• Esportazione CSV: esporta la timeline per i flussi di reporting
• Esportazione Markdown: esporta le note come file .md autonomi o archivio zip con allegati
• Incolla Immagini: incolla screenshot direttamente nelle note (Ctrl+V)

Funzionalità delle Note

Incollare Immagini

Incolla screenshot direttamente nell'editor delle note:

• Ctrl+V per incollare dagli appunti
• Supporta PNG, JPEG, GIF e WebP
• Le immagini vengono salvate su disco e collegate tramite markdown
• Le immagini vengono visualizzate nel pannello di anteprima

Esportare Note

Esportazione Singola Nota:

• Fai clic sul pulsante di esportazione (↓) nella barra degli strumenti
• Seleziona "Esporta nota corrente"
• Scarica come file .md con frontmatter YAML

Esporta Tutte le Note:

• Fai clic sul pulsante di esportazione (↓) nella barra degli strumenti
• Seleziona "Esporta tutte le note"
• Scarica come archivio .zip contenente:
  • Tutte le note come file .md
  • Cartella attachments/ con le immagini

I file esportati si aprono correttamente in Obsidian, VS Code o qualsiasi visualizzatore markdown.

Comandi

chronix [COMANDO] [OPZIONI]

Comandi:
  init          Inizializza account e segreto di sessione
  serve         Avvia il server (predefinito)

Opzioni Init:
  --username    Nome utente account (predefinito: admin)
  --force       Rigenera il segreto di sessione
  --db, -d      Percorso del file database

Opzioni Server:
  --host, -H    Indirizzo di bind (predefinito: 0.0.0.0)
  --port, -p    Porta (predefinito: 8000)
  --local       Bind solo su localhost
  --db, -d      Percorso del file database (predefinito: ./chronix.db)
  --no-browser  Salta l'apertura automatica del browser

Configurazione

Imposta tramite ~/.config/chronix/chronix.env o .env:

Autore

Tyrrell Brewster — GitHub | Sito Web

Licenza

Questo progetto è concesso in licenza ai termini della GNU Affero General Public License v3.0 (AGPL-3.0-only).

Il codice sorgente è disponibile su github.com/icecubesandwich/chronix. Gli utenti di rete possono anche accedere alle informazioni sulla licenza tramite l'endpoint /license.

Contribuire

Vedi CONTRIBUTING.md per le linee guida su come inviare modifiche.

Sicurezza

Vedi SECURITY.md per segnalare vulnerabilità.