kimal3

Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.

Wer mit Claude Code arbeitet, baut echte Dinge — und dokumentiert sie hinterher nicht, weil das ein zweiter Arbeitsschritt in einem anderen Fenster wäre. kimal3 schließt diese Lücke: Am Ende einer Sitzung trägt Claude das fertige Projekt selbst in dein KImal3-Erfolgsprofil ein. Du gibst es dort nur noch frei.

Voraussetzung: ein KImal3-Konto mit Pro. Ohne Pro meldet sich dieses Werkzeug ab, ohne etwas zu tun. Was Pro enthält und wie du es bekommst: https://app.kimal3.de/pro

Loslegen

Einmal pro Rechner:

npm install -g kimal3   # das Werkzeug installieren (setzt Node.js voraus)
kimal3 login            # diesen Rechner mit deinem Konto verbinden
kimal3 skill install    # Claude beibringen, das Werkzeug zu benutzen

In Claude Code? Dann lass es einrichten, statt es zu tippen — der Satz zum Kopieren steht auf https://app.kimal3.de/pro. Nur kimal3 login tippst du selbst (dort mit ! davor), weil die Bestätigung im Browser einen Menschen braucht.

login zeigt dir eine Adresse und einen achtstelligen Code. Die Adresse rufst du selbst auf und bestätigst den Code dort in deinem eingeloggten Konto — so wie bei gh auth login. Es wird kein Passwort ins Terminal getippt.

Befehle

kimal3                    Zeigt, ob dieser Rechner angemeldet ist
kimal3 login              Diesen Rechner mit deinem Konto verbinden
kimal3 skill install      Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben
kimal3 arbeitsplatz neu   Den ganzen KI-Arbeitsplatz anlegen — Firmenebene und Werkbank
kimal3 werkbank neu       Nur eine eigene Werkbank in einer bestehenden Firma anlegen
kimal3 kontext runter     Den Firmenkontext holen — CLAUDE.md und die fünf Dateien in kontext/
kimal3 kontext fragen     Zeigen, welche Fragen über deine Firma noch unbeantwortet sind
kimal3 kontext hoch       Deine lokalen Änderungen an den fünf Kontext-Dateien hochschicken
kimal3 projekt neu …      Ein Projekt ins Erfolgsprofil eintragen
kimal3 projekt liste      Deine eingetragenen Projekte anzeigen
kimal3 firma daten        Die Daten deiner Firma holen, damit Claude sie auswerten kann
kimal3 wache              Läuft von selbst beim Start von Claude: prüft Zugang, Nachricht, Version, Skill
kimal3 wache aus          Die tägliche Prüfung abschalten — sie sagt dann nichts mehr
kimal3 wache an           Sie wieder einschalten
kimal3 logout             Verbindung wieder aufheben

Mehr zu einem Befehl: kimal3 projekt neu --help

Was eingetragen wird

Nur, was du eingibst — Titel, Beschreibung, optional ein Link. Dein Code wird nicht gelesen, nicht hochgeladen und nicht analysiert. Das Werkzeug schreibt ausschließlich über die KImal3-App und hat keinen eigenen Datenbankzugang.

Eingetragene Projekte sind zunächst nicht öffentlich. Sie erscheinen in deinem Erfolgsprofil, und du entscheidest dort, was sichtbar wird.

Rückgabewerte

Für Skripte und für Claude selbst:

| Wert | Bedeutung | Hilft | |---|---|---| | 0 | hat geklappt | — | | 1 | Eingabe unvollständig, nichts gefunden — oder deine Claude-Einstellungen sind nicht lesbar | die Meldung lesen, sie nennt den Fall | | 2 | nicht angemeldet | kimal3 login | | 3 | gerade nicht erreichbar | später noch einmal | | 4 | kein Pro-Konto | erneutes Versuchen hilft nicht |

Der Unterschied zwischen 3 und 4 ist Absicht: Bei 3 lohnt ein zweiter Versuch, bei 4 nie.

Update-Hinweise

Steht eine neuere Fassung bereit, schreibt kimal3 nach dem Befehl eine eingerückte Zeile — höchstens einmal am Tag:

  →  kimal3 0.2.0 ist da.  npm i -g kimal3@latest && kimal3 skill install

Sie geht auf stderr, nicht auf stdout: kimal3 firma daten > firma.json bleibt damit sauberes JSON. Sie ändert den Rückgabewert nicht — eine 0 bleibt eine 0. Und kimal3 installiert nichts von selbst; der Befehl steht in der Zeile, ausführen tust du ihn.

Dasselbe gilt für die Skill-Dateien: Sind die in ~/.claude/skills/kimal3/ älter als das installierte Werkzeug, sagt kimal3 es — dafür braucht es kein Netz.

Die tägliche Prüfung — und wie du sie abstellst

kimal3 skill install trägt eine Zeile in deine Claude-Einstellungen ein (~/.claude/settings.json). Sie sorgt dafür, dass beim Start von Claude kimal3 wache läuft — still, wenn nichts ansteht; eine offene Aufgabe (Zugang, Fassung, Skill) meldet sie in jeder Sitzung, bis sie erledigt ist. Die Prüfung sieht nach, ob dein Zugang noch gilt, ob eine neuere Fassung bereitsteht, ob deine /k3-Befehle veraltet sind und ob eine Nachricht von uns anliegt.

Sie meldet sich nur, wenn wirklich etwas ansteht. Ist alles in Ordnung, sagt sie nichts.

Willst du sie nicht:

kimal3 wache aus     # ab jetzt still
kimal3 wache an      # doch wieder

Nach kimal3 wache aus wird nichts mehr an unseren Server geschickt — die Prüfung steigt aus, bevor sie irgendetwas fragt. Gemessen: mit Prüfung rund 0,9 Sekunden, ohne rund 0,19 Sekunden, und in den 0,19 Sekunden verlässt kein Byte deinen Rechner.

Die Zeile in den Einstellungen bleibt dabei stehen, damit kimal3 wache an sofort wirkt und wir deine Einstellungsdatei nicht noch einmal anfassen müssen. Es startet also weiter ein kleines Programm von uns, das nach rund 0,19 Sekunden wieder aufhört.

Soll auch das nicht mehr passieren, nimm die Zeile selbst heraus: In ~/.claude/settings.json steht unter hooks → SessionStart ein Eintrag, dessen Befehl mit kimal3 wache beginnt (heute: kimal3 wache --hook, in älteren Installationen ohne den Zusatz). ⚠️ Der Zusatz --hook gehört in die Einstellungsdatei, nicht ins Terminal — getippt wird immer nur kimal3 wache. Lösch diesen einen Eintrag — den Rest der Datei lass, wie er ist.

Voraussetzungen

Node.js 20 oder neuer. Sonst nichts — das Werkzeug bringt keine fremden Bibliotheken mit.

Lizenz

Proprietär. Die Nutzung ist Inhabern eines gültigen KImal3-Pro-Kontos gestattet; Weitergabe, Veränderung und Weiterverwendung des Codes sind nicht erlaubt.

© KImal3 · https://kimal3.de