Chronix

Selbst gehosteter kollaborativer Arbeitsbereich für Pentester und Red‑Team‑Operatoren. Erfasst Notizen, Befehle, Ausgaben und operativen Kontext während Sicherheitsengagements.

Schnellstart

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

# Initialisieren (erstellt Konto und Sitzungsgeheimnis)
chronix init

# Ausführen
chronix

Der Browser öffnet sich unter http://localhost:8000. Die Zugangsdaten werden während der Initialisierung einmalig angezeigt – bewahren Sie sie sicher auf.

Funktionen

• Zeitachsenprotokollierung: Zeitgestempelte Einträge mit Quell‑, Ziel‑, Tool‑, Befehls‑, Ausgabe‑ und Ergebnisfeldern
• Kollaborative Notizen: Markdown‑Seiten mit automatischer Speicherung und Versionsverlauf
• Echtzeit‑Synchronisation: WebSocket‑Updates über gleichzeitige Sitzungen hinweg
• Filter & Suche: Zeitachse nach Tool, Ziel oder Text filtern
• CSV‑Export: Zeitachse für Berichtsworkflows exportieren
• Markdown‑Export: Notizen als eigenständige .md‑Dateien oder als ZIP‑Archiv mit Anhängen exportieren
• Bilder einfügen: Screenshots direkt in Notizen einfügen (Strg+V)

Notiz‑Funktionen

Bilder einfügen

Screenshots direkt in den Notizeneditor einfügen:

• Strg+V zum Einfügen aus der Zwischenablage
• Unterstützt PNG, JPEG, GIF und WebP
• Bilder werden auf der Festplatte gespeichert und per Markdown verlinkt
• Bilder werden im Vorschaubereich angezeigt

Notizen exportieren

Einzelne Notiz exportieren:

• Klicken Sie auf die Export‑Schaltfläche (↓) in der Symbolleiste
• Wählen Sie „Aktuelle Notiz exportieren"
• Herunterladen als .md‑Datei mit YAML‑Frontmatter

Alle Notizen exportieren:

• Klicken Sie auf die Export‑Schaltfläche (↓) in der Symbolleiste
• Wählen Sie „Alle Notizen exportieren"
• Herunterladen als .zip mit:
  • Alle Notizen als .md‑Dateien
  • Ordner attachments/ mit Bildern

Exportierte Dateien lassen sich sauber in Obsidian, VS Code oder jedem Markdown‑Betrachter öffnen.

Befehle

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

Konfiguration

Einrichtung über ~/.config/chronix/chronix.env oder .env:

Autor

Tyrrell Brewster — GitHub | Website

Lizenz

Dieses Projekt ist lizenziert unter der GNU Affero General Public License v3.0 (AGPL‑3.0‑only).

Der Quellcode ist verfügbar unter github.com/icecubesandwich/chronix. Netzwerkbenutzer können Lizenzinformationen auch über den /license‑Endpunkt abrufen.

Mitwirken

Siehe CONTRIBUTING.md für Richtlinien zum Einreichen von Änderungen.

Sicherheit

Siehe SECURITY.md für die Meldung von Schwachstellen.