@whenlabs/when

Sechs Tools. Eine Installation.

Ein einzelnes installierbares Toolkit, das sechs WhenLabs-Entwicklertools in Ihren Claude Code / KI-Coding-Agent-Workflow integriert. Nach der Installation stehen alle Tools als MCP-Tools in jeder Sitzung zur Verfügung – Claude verwendet sie automatisch, wenn sie relevant sind.

Fünf Tools (stale, envalid, berth, aware, vow) verfügen über CLI-Scan-Modi und laufen nach einem Zeitplan. Velocity ist das sechste Tool – es ist immer aktiv und eingebettet (basiert auf SQLite), daher hat es keinen CLI-Scan-Modus und erscheint nicht in der Ausgabe von doctor/watch/init/ci.

Installation

npx @whenlabs/when install

Dies ist eine einmalige Einrichtung. Nach der Installation stehen alle sechs Tools in jedem Projekt zur Verfügung, das Sie mit Claude Code öffnen.

Was es bewirkt

Die Ausführung von npx @whenlabs/when install bewirkt Folgendes:

1. Registrierung eines einzelnen MCP-Servers (whenlabs) in Ihrer Claude Code-Konfiguration – alle sechs Tools, einschließlich velocity, werden von einem Server bereitgestellt.

2. Einfügen von CLAUDE.md-Anweisungen, damit Claude weiß, wann jedes Tool automatisch zu verwenden ist – und diese gegenüber Shell-Befehlen bevorzugt.

3. Bereinigung von veralteten velocity-mcp-Registrierungen (velocity ist jetzt gebündelt).

Sobald die Verbindung hergestellt ist, kann Claude jedes Tool direkt aufrufen, ohne dass Sie danach fragen müssen. Nach einem Refactoring könnte Claude beispielsweise stale_scan ausführen, um auf Dokumentations-Drift zu prüfen, oder vor einer Veröffentlichung vow_check, um Lizenzen zu validieren.

Proaktive Hintergrund-Scans

Tools laufen automatisch im Hintergrund nach einem Zeitplan und melden Ergebnisse in der Statuszeile von Claude Code:

Es werden nur Probleme angezeigt – wenn alles in Ordnung ist, bleibt die Statuszeile übersichtlich. Wenn Claude ein Problem in der Statuszeile sieht, weist es Sie proaktiv darauf hin und bietet an, es zu beheben.

MCP-Tools

Diese Tools stehen Claude nach der Installation in jeder Sitzung zur Verfügung:

Diese Tabelle zeigt eine Auswahl der Highlights. Führen Sie when <tool> --help für alle verfügbaren Befehle pro Tool aus.

Tool-übergreifende Intelligenz

Tools schlagen automatisch Folgeaktionen vor, wenn sie Probleme erkennen, die für andere Tools relevant sind. Zum Beispiel löst aware_init einen stale_scan aus, wenn neue Dateien generiert werden, und envalid_detect schlägt berth_register vor, wenn es Umgebungsvariablen für Service-URLs findet. Diese kaskadierenden Vorschläge erscheinen als "Tipp:"-Zeilen in der Tool-Ausgabe.

Unterstützung für mehrere Editoren

Installieren Sie MCP-Server neben Claude Code auch in anderen Editoren:

npx @whenlabs/when install --cursor     # Cursor
npx @whenlabs/when install --vscode     # VS Code
npx @whenlabs/when install --windsurf   # Windsurf
npx @whenlabs/when install --all        # All supported editors

Ohne Flags zielt install nur auf Claude Code ab.

CLI-Nutzung

Sie können Tools auch direkt über die Befehlszeile ausführen:

when init            # Onboard a project — bootstrap configs, run all tools, auto-fix
when config          # Show unified .whenlabs.yml config
when config init     # Generate .whenlabs.yml from existing tool configs
when config validate # Validate config structure
when stale scan
when stale fix       # Auto-fix documentation drift
when envalid validate
when envalid detect --generate  # Generate schema from code
when berth status
when berth resolve   # Auto-resolve port conflicts
when aware init
when vow scan
when vow hook install  # Install pre-commit license hook
when status          # Show installation status
when doctor          # Run all tools, show unified health report
when doctor --watch  # Continuous monitoring dashboard
when watch           # Background daemon for status line
when ci              # Run checks for CI (exits 1 on issues)

when init

Ein Befehl, um jedes Projekt vollständig einzurichten:

1. Bootstrap — erstellt .env.schema, .vow.json, .stale.yml und registriert berth-Ports basierend auf Ihrem Projekt

2. Scan — führt alle 5 CLI-Tools parallel aus

3. Auto-fix — behebt automatisch stale-Drift, falls erkannt

4. Config — generiert eine einheitliche .whenlabs.yml aus den gebootstrappten Konfigurationen

when config

Verwalten Sie die einheitliche .whenlabs.yml Projektkonfiguration. Alle sechs Tools lesen ihre Einstellungen aus dieser einzigen Datei anstelle von separaten Konfigurationsdateien. Unterbefehle: init (aus bestehenden Konfigurationen generieren), validate (Struktur prüfen).

when doctor

Führt alle 5 CLI-Tools für das aktuelle Projekt aus und zeigt einen einheitlichen Gesundheitsbericht an. Unterstützt --json für maschinenlesbare Ausgaben und --watch für kontinuierliche Überwachung mit einem Live-Dashboard.

when watch

Hintergrund-Daemon, der alle 5 CLI-Tools in Intervallen ausführt und Ergebnisse in ~/.whenlabs/status.json schreibt. Unterstützt die Integration der Claude Code-Statuszeile. Verwenden Sie --once für einen einzelnen Scan oder --interval <seconds>, um den Zeitplan anzupassen.

when ci

Führt stale-, envalid- und vow-Prüfungen aus – beendet mit Exit-Code 1, wenn ein Tool Probleme findet. Entwickelt für CI-Pipelines:

when ci --ci         # GitHub Actions annotations (::error file=X::message)
when ci --json       # Machine-readable JSON output

GitHub Action

- uses: WhenLabs-org/when@main
  with:
    checks: stale,envalid,vow

Deinstallation

npx @whenlabs/when uninstall

Entfernt den MCP-Server und bereinigt die CLAUDE.md-Anweisungen.

Lizenz

MIT – siehe LICENSE

Erstellt von Siddharth bei WhenLabs