kimal3 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +79 -74
  2. package/dist/anmeldung.js +1 -1
  3. package/dist/kimal3.js +1 -1
  4. package/package.json +5 -2
  5. package/skill/SKILL.md +8 -4
package/README.md CHANGED
@@ -1,74 +1,79 @@
1
- # kimal3
2
-
3
- **Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.**
4
-
5
- Wer mit Claude Code arbeitet, baut echte Dinge — und dokumentiert sie hinterher nicht,
6
- weil das ein zweiter Arbeitsschritt in einem anderen Fenster wäre. `kimal3` schließt
7
- diese Lücke: Am Ende einer Sitzung trägt Claude das fertige Projekt selbst in dein
8
- KImal3-Erfolgsprofil ein. Du gibst es dort nur noch frei.
9
-
10
- > **Voraussetzung: ein KImal3-Konto mit Pro.**
11
- > Ohne Pro meldet sich dieses Werkzeug ab, ohne etwas zu tun.
12
- > Was Pro enthält und wie du es bekommst: **https://kimal3-app.vercel.app/pro**
13
-
14
- ## Loslegen
15
-
16
- Zwei Befehle, einmal pro Rechner:
17
-
18
- ```bash
19
- npx kimal3 login # diesen Rechner mit deinem Konto verbinden
20
- npx kimal3 skill install # Claude beibringen, das Werkzeug zu benutzen
21
- ```
22
-
23
- `login` zeigt dir einen achtstelligen Code und öffnet den Browser. Dort bestätigst du
24
- ihn in deinem eingeloggten Konto — so wie bei `gh auth login`. **Es wird kein Passwort
25
- ins Terminal getippt.**
26
-
27
- ## Befehle
28
-
29
- ```
30
- kimal3 Zeigt, ob dieser Rechner angemeldet ist
31
- kimal3 login Diesen Rechner mit deinem Konto verbinden
32
- kimal3 logout Verbindung wieder aufheben
33
- kimal3 projekt neu … Ein Projekt ins Erfolgsprofil eintragen
34
- kimal3 projekt liste Deine eingetragenen Projekte anzeigen
35
- kimal3 skill install Claude beibringen, dieses Werkzeug zu benutzen
36
- ```
37
-
38
- Mehr zu einem Befehl: `kimal3 projekt neu --help`
39
-
40
- ## Was eingetragen wird
41
-
42
- Nur, was du eingibst — Titel, Beschreibung, optional ein Link. **Dein Code wird nicht
43
- gelesen, nicht hochgeladen und nicht analysiert.** Das Werkzeug schreibt ausschließlich
44
- über die KImal3-App und hat keinen eigenen Datenbankzugang.
45
-
46
- Eingetragene Projekte sind zunächst **nicht öffentlich**. Sie erscheinen in deinem
47
- Erfolgsprofil, und du entscheidest dort, was sichtbar wird.
48
-
49
- ## Rückgabewerte
50
-
51
- Für Skripte und für Claude selbst:
52
-
53
- | Wert | Bedeutung | Hilft |
54
- |---|---|---|
55
- | `0` | hat geklappt | — |
56
- | `1` | Eingabe unvollständig oder nichts gefunden | Eingabe prüfen |
57
- | `2` | nicht angemeldet | `kimal3 login` |
58
- | `3` | gerade nicht erreichbar | später noch einmal |
59
- | `4` | kein Pro-Konto | erneutes Versuchen hilft **nicht** |
60
-
61
- Der Unterschied zwischen `3` und `4` ist Absicht: Bei `3` lohnt ein zweiter Versuch,
62
- bei `4` nie.
63
-
64
- ## Voraussetzungen
65
-
66
- Node.js 20 oder neuer. Sonst nichts — das Werkzeug bringt **keine fremden Bibliotheken**
67
- mit.
68
-
69
- ## Lizenz
70
-
71
- Proprietär. Die Nutzung ist Inhabern eines gültigen KImal3-Pro-Kontos gestattet;
72
- Weitergabe, Veränderung und Weiterverwendung des Codes sind nicht erlaubt.
73
-
74
- © KImal3 · https://kimal3.de
1
+ # kimal3
2
+
3
+ **Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.**
4
+
5
+ Wer mit Claude Code arbeitet, baut echte Dinge — und dokumentiert sie hinterher nicht,
6
+ weil das ein zweiter Arbeitsschritt in einem anderen Fenster wäre. `kimal3` schließt
7
+ diese Lücke: Am Ende einer Sitzung trägt Claude das fertige Projekt selbst in dein
8
+ KImal3-Erfolgsprofil ein. Du gibst es dort nur noch frei.
9
+
10
+ > **Voraussetzung: ein KImal3-Konto mit Pro.**
11
+ > Ohne Pro meldet sich dieses Werkzeug ab, ohne etwas zu tun.
12
+ > Was Pro enthält und wie du es bekommst: **https://kimal3-app.vercel.app/pro**
13
+
14
+ ## Loslegen
15
+
16
+ Einmal pro Rechner:
17
+
18
+ ```bash
19
+ npm install -g kimal3 # das Werkzeug installieren (setzt Node.js voraus)
20
+ kimal3 login # diesen Rechner mit deinem Konto verbinden
21
+ kimal3 skill install # Claude beibringen, das Werkzeug zu benutzen
22
+ ```
23
+
24
+ > **In Claude Code?** Dann lass es einrichten, statt es zu tippen — der Satz zum Kopieren steht
25
+ > auf **https://kimal3-app.vercel.app/pro**. Nur `kimal3 login` tippst du selbst (dort mit `!`
26
+ > davor), weil die Bestätigung im Browser einen Menschen braucht.
27
+
28
+ `login` zeigt dir eine Adresse und einen achtstelligen Code. Die Adresse rufst du selbst
29
+ auf und bestätigst den Code dort in deinem eingeloggten Konto — so wie bei `gh auth login`.
30
+ **Es wird kein Passwort ins Terminal getippt.**
31
+
32
+ ## Befehle
33
+
34
+ ```
35
+ kimal3 Zeigt, ob dieser Rechner angemeldet ist
36
+ kimal3 login Diesen Rechner mit deinem Konto verbinden
37
+ kimal3 logout Verbindung wieder aufheben
38
+ kimal3 projekt neu … Ein Projekt ins Erfolgsprofil eintragen
39
+ kimal3 projekt liste Deine eingetragenen Projekte anzeigen
40
+ kimal3 skill install Claude beibringen, dieses Werkzeug zu benutzen
41
+ ```
42
+
43
+ Mehr zu einem Befehl: `kimal3 projekt neu --help`
44
+
45
+ ## Was eingetragen wird
46
+
47
+ Nur, was du eingibst — Titel, Beschreibung, optional ein Link. **Dein Code wird nicht
48
+ gelesen, nicht hochgeladen und nicht analysiert.** Das Werkzeug schreibt ausschließlich
49
+ über die KImal3-App und hat keinen eigenen Datenbankzugang.
50
+
51
+ Eingetragene Projekte sind zunächst **nicht öffentlich**. Sie erscheinen in deinem
52
+ Erfolgsprofil, und du entscheidest dort, was sichtbar wird.
53
+
54
+ ## Rückgabewerte
55
+
56
+ Für Skripte und für Claude selbst:
57
+
58
+ | Wert | Bedeutung | Hilft |
59
+ |---|---|---|
60
+ | `0` | hat geklappt | — |
61
+ | `1` | Eingabe unvollständig oder nichts gefunden | Eingabe prüfen |
62
+ | `2` | nicht angemeldet | `kimal3 login` |
63
+ | `3` | gerade nicht erreichbar | später noch einmal |
64
+ | `4` | kein Pro-Konto | erneutes Versuchen hilft **nicht** |
65
+
66
+ Der Unterschied zwischen `3` und `4` ist Absicht: Bei `3` lohnt ein zweiter Versuch,
67
+ bei `4` nie.
68
+
69
+ ## Voraussetzungen
70
+
71
+ Node.js 20 oder neuer. Sonst nichts — das Werkzeug bringt **keine fremden Bibliotheken**
72
+ mit.
73
+
74
+ ## Lizenz
75
+
76
+ Proprietär. Die Nutzung ist Inhabern eines gültigen KImal3-Pro-Kontos gestattet;
77
+ Weitergabe, Veränderung und Weiterverwendung des Codes sind nicht erlaubt.
78
+
79
+ © KImal3 · https://kimal3.de
package/dist/anmeldung.js CHANGED
@@ -3,7 +3,7 @@ import { homedir } from "node:os";
3
3
  import { join } from "node:path";
4
4
  /**
5
5
  * Wo die App wohnt. Ueberschreibbar fuers lokale Entwickeln:
6
- * KIMAL3_URL=http://localhost:3000 npx kimal3 projekt liste
6
+ * KIMAL3_URL=http://localhost:3000 kimal3 projekt liste
7
7
  */
8
8
  export const BASIS_URL = process.env.KIMAL3_URL ?? "https://kimal3-app.vercel.app";
9
9
  const ORDNER = join(homedir(), ".kimal3");
package/dist/kimal3.js CHANGED
@@ -33,7 +33,7 @@ const HILFE = `
33
33
  * Hilfe plus Zustand.
34
34
  *
35
35
  * ⚠️ Bewusst KEIN automatischer Login (Frage von Dennis, 2026-08-13, am selben
36
- * Abend nochmals bestaetigt): Wer `npx kimal3` tippt, um sich das Ding
36
+ * Abend nochmals bestaetigt): Wer `kimal3` tippt, um sich das Ding
37
37
  * anzusehen, bekaeme sonst unvermittelt einen Anmelde-Vorgang samt Browser.
38
38
  * Und was taete der zweite Aufruf, wenn man schon angemeldet ist? Es gaebe
39
39
  * zwei Wege zum selben Ergebnis, einer davon unerwartet.
package/package.json CHANGED
@@ -1,12 +1,15 @@
1
1
  {
2
2
  "name": "kimal3",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
5
5
  "type": "module",
6
6
  "bin": { "kimal3": "dist/kimal3.js" },
7
7
  "files": ["dist", "skill", "README.md"],
8
8
  "engines": { "node": ">=20" },
9
- "scripts": { "build": "tsc -p tsconfig.json" },
9
+ "scripts": {
10
+ "build": "tsc -p tsconfig.json",
11
+ "prepublishOnly": "npm run build"
12
+ },
10
13
  "keywords": ["kimal3", "cli"],
11
14
  "homepage": "https://kimal3-app.vercel.app/pro",
12
15
  "license": "SEE LICENSE IN README.md"
package/skill/SKILL.md CHANGED
@@ -5,15 +5,19 @@ description: Use when the user has finished an AI project and wants it recorded
5
5
 
6
6
  # kimal3 — Projekte ins Erfolgsprofil eintragen
7
7
 
8
+ > **`kimal3` nicht gefunden?** Zwei Gründe, und sie brauchen verschiedene Antworten:
9
+ > die globale Installation fehlt (`npm install -g kimal3`) — **oder** sie ist da, aber diese
10
+ > Sitzung kennt den Suchpfad noch nicht, dann hilft nur ein Neustart von Claude.
11
+
8
12
  ## Wann
9
13
  Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
10
14
 
11
15
  ## Erst nachsehen, dann schreiben
12
- `npx kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
16
+ `kimal3 projekt liste` — steht es schon da, **nicht** noch einmal eintragen.
13
17
 
14
18
  ## Eintragen
15
- `npx kimal3 projekt neu --titel "…" [--stunden 6] [--ergebnis 1200] [--symbol bot]`
16
- Alle Optionen: `npx kimal3 projekt neu --help`
19
+ `kimal3 projekt neu --titel "…" [--stunden 6] [--ergebnis 1200] [--symbol bot]`
20
+ Alle Optionen: `kimal3 projekt neu --help`
17
21
 
18
22
  ## 🔑 Zahlen nie erfinden
19
23
  Zeitersparnis, Umsatz und Ergebnis sind Behauptungen über die Wirklichkeit eines Menschen — und
@@ -21,7 +25,7 @@ sie stehen anschließend **öffentlich** auf einer Seite mit seinem Namen. Ist e
21
25
  genannt worden: **fragen** oder das Feld weglassen. Niemals schätzen.
22
26
 
23
27
  ## Nicht angemeldet?
24
- Dem Menschen `npx kimal3 login` zeigen und ihn selbst bestätigen lassen. Die Anmeldung **nie**
28
+ Dem Menschen `kimal3 login` zeigen und ihn selbst bestätigen lassen. Die Anmeldung **nie**
25
29
  selbst versuchen — sie braucht einen Menschen, der im Browser bestätigt.
26
30
 
27
31
  ## Kein Pro-Zugang (Rückgabewert 4)