Chronix

Espace de travail collaboratif auto-hébergé pour pentesters et opérateurs red team. Capture les notes, commandes, sorties et le contexte opérationnel lors des engagements de sécurité.

Démarrage rapide

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

# Initialisation (crée un compte et une clé de session)
chronix init

# Lancer
chronix

Le navigateur s'ouvre à http://localhost:8000. Les identifiants s'affichent une seule fois lors de l'initialisation — conservez-les de manière sécurisée.

Fonctionnalités

• Journalisation chronologique : Entrées horodatées avec champs source, destination, outil, commande, sortie et résultat
• Notes collaboratives : Pages Markdown avec sauvegarde automatique et historique des versions
• Synchronisation en temps réel : Mises à jour WebSocket sur les sessions concurrentes
• Filtre et recherche : Filtrer la chronologie par outil, cible ou texte
• Export CSV : Exporter la chronologie pour les workflows de rapport
• Export Markdown : Exporter les notes sous forme de fichiers .md autonomes ou d'archive zip avec pièces jointes
• Collage d'images : Coller des captures d'écran directement dans les notes (Ctrl+V)

Fonctionnalités des notes

Coller des images

Collez des captures d'écran directement dans l'éditeur de notes :

• Ctrl+V pour coller depuis le presse-papiers
• Prend en charge PNG, JPEG, GIF et WebP
• Les images sont stockées sur le disque et liées via Markdown
• Les images s'affichent dans le panneau de prévisualisation

Exporter les notes

Export d'une seule note :

• Cliquez sur le bouton d'export (↓) dans la barre d'outils
• Sélectionnez « Exporter la note actuelle »
• Téléchargement sous forme de fichier .md avec en-tête YAML

Exporter toutes les notes :

• Cliquez sur le bouton d'export (↓) dans la barre d'outils
• Sélectionnez « Exporter toutes les notes »
• Téléchargement sous forme de .zip contenant :
  • Toutes les notes sous forme de fichiers .md
  • Dossier attachments/ avec les images

Les fichiers exportés s'ouvrent proprement dans Obsidian, VS Code ou tout visualiseur Markdown.

Commandes

chronix [COMMAND] [OPTIONS]

Commands:
  init          Initialize account and session secret
  serve         Start server (default)

Init Options:
  --username    Account username (default: admin)
  --force       Regenerate session secret
  --db, -d      Database file path

Server Options:
  --host, -H    Bind address (default: 0.0.0.0)
  --port, -p    Port (default: 8000)
  --local       Bind to localhost only
  --db, -d      Database file path (default: ./chronix.db)
  --no-browser  Skip automatic browser launch

Configuration

Définie via ~/.config/chronix/chronix.env ou .env :

Variable	Défaut	Description
CHRONIX_SESSION_SECRET	(requis)	Secret hexadécimal de 64 caractères pour la signature des cookies
CHRONIX_DB_PATH	./chronix.db	Emplacement du fichier de base de données
CHRONIX_ATTACHMENTS_PATH	./attachments	Stockage des pièces jointes images
CHRONIX_MAX_ATTACHMENT_SIZE	10485760	Taille maximale d'image (10 Mo)
CHRONIX_SESSION_EXPIRE_HOURS	24	Durée de vie de la session
CHRONIX_BEHIND_PROXY	false	Activer lorsqu'on est derrière un proxy TLS
CHRONIX_RATE_LIMIT_LOGIN	5	Tentatives de connexion avant limite de débit

Auteur

Tyrrell Brewster — GitHub | Site web

Licence

Ce projet est sous licence GNU Affero General Public License v3.0 (AGPL-3.0-only).

Le code source est disponible sur github.com/icecubesandwich/chronix. Les utilisateurs du réseau peuvent également consulter les informations de licence via le point d'accès /license.

Contribution

Consultez CONTRIBUTING.md pour les directives de soumission de modifications.

Sécurité

Consultez SECURITY.md pour signaler des vulnérabilités.