Projekt-Registry statt festem ~/claude-projects-Root: projects.json (Name → Pfad, ~-relativ) mit Alt-Layout-Fallback; Ordner frei mappbar (add/remove_project, Wizard-Ablageort); Session-Sync per Projekt-Repo (add/commit/pull --rebase/push) statt git-sync-Skript; README + GitHub-Release-Fassung

2026-07-05 13:58:52 +02:00
parent ddd8984462
commit ec3d2f4fb3
5 changed files with 419 additions and 111 deletions
@@ -1,5 +1,73 @@
-# Vue 3 + TypeScript + Vite
+# ai-control

-This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
+Pool- und Session-Verwaltung für [Claude Code](https://claude.com/claude-code) auf macOS — als Tray-App mit eingebautem Terminal. Linux- und Windows-Integration folgen.

-Learn more about the recommended Project Setup and IDE Support in the [Vue Docs TypeScript Guide](https://vuejs.org/guide/typescript/overview.html#project-setup).
+> Der gesamte Code dieses Projekts wurde von Claude (Claude Code) generiert.
+
+## Zweck
+
+Wer Claude Code mit mehreren Accounts bzw. Credential-Sets betreibt, muss pro Session das richtige `CLAUDE_CONFIG_DIR` samt Keychain-Eintrag treffen. ai-control macht daraus Klicks:
+
+- **Pools** — benannte Credential-Sets (OAuth-Login oder API-Key) unter `~/.config/ai-control/pools/<pool>`. Jeder Pool ist ein eigenständiges Claude-Config-Verzeichnis mit eigenem Keychain-Eintrag.
+- **Projekte** — beliebige Verzeichnisse, gemappt über eine Registry (`~/.config/ai-control/projects.json`, Name → Pfad; Home-Pfade als `~/…` und damit maschinenübergreifend stabil). Ohne Registry gilt das Alt-Layout: Unterordner von `~/claude-projects` mit `.claude`-Ordner. Jedem Projekt ist ein Pool zugeordnet; dazu Terminal-Einstellungen (Theme, Icon, Fenstertitel).
+- **Sessions** — pro Projekt ein eingebautes Terminal (xterm.js + PTY), das Claude Code mit der Pool-Umgebung startet. Jedes Terminal läuft als eigener Prozess mit eigenem Dock-Icon und Cmd-Tab-Eintrag.
+- **Tray** — die App selbst ist eine reine Menüleisten-App ohne Dock-Eintrag. Das Tray-Menü listet alle Projekte mit Icon und Status-Punkt (grün = läuft); Klick startet das Projekt oder holt das laufende Terminal nach vorn.
+- **Session-Watcher** — erkennt das Ende einer Session über das Verschwinden des Terminal-Prozesses und synct dann (opt-in) das Git-Repo, in dem das Projekt liegt: add → commit → pull --rebase → push.
+
+## Projektaufbau
+
+```
+├── index.html            Haupt-UI (Projekt-/Pool-Verwaltung)
+├── terminal.html         Terminal-Fenster (xterm.js)
+├── src/                  Frontend: Vue 3 + TypeScript
+├── src-tauri/
+│   ├── src/lib.rs        Tauri-Commands: Projekte, Pools, Keychain,
+│   │                     OAuth-Login, Tray-Menü, Session-Watcher
+│   ├── src/terminal.rs   PTY-Sessions (portable-pty), Terminal-Fenster,
+│   │                     Dock-Icon, Fokussieren laufender Terminals
+│   └── icons/            App- und Tray-Icons
+├── dev.sh                Entwicklungsmodus (tauri dev)
+└── build.sh              Release-Build (.app-Bundle)
+```
+
+Zwei Prozessrollen aus einem Binary:
+
+- **Haupt-App** (`ai-control`) — Tray, Hauptfenster, Verwaltung, Watcher.
+- **Terminal-Prozess** (`ai-control --terminal <projekt>`) — ein Fenster mit eigener PTY; startet Claude Code im Projektverzeichnis mit `CLAUDE_CONFIG_DIR` des zugeordneten Pools.
+
+Laufende Projekte werden über die Terminal-Prozesse erkannt (`pgrep` auf `--terminal <projekt>`), ohne Zustandsdatei.
+
+## Tooling
+
+| Bereich   | Stack |
+|-----------|-------|
+| Shell     | Tauri 2 (Rust) |
+| Frontend  | Vue 3, TypeScript, Vite |
+| Terminal  | xterm.js, portable-pty |
+| macOS     | objc2 / objc2-app-kit (Dock-Icon, Fenster-Fokus, Tray) |
+| Secrets   | keyring (macOS Keychain) |
+
+## Entwicklung
+
+```sh
+./dev.sh      # tauri dev mit Hot-Reload
+./build.sh    # Release-Build; Bundle landet in src-tauri/target/release/bundle/macos.noindex/
+```
+
+`build.sh` verschiebt das Bundle in ein `.noindex`-Verzeichnis und trägt es aus Launch Services aus, damit Spotlight nur die installierte Kopie findet. Installation: `ai-control.app` nach `~/Applications` kopieren.
+
+Voraussetzungen: Rust (stable), Node.js/npm, macOS. `dev.sh`/`build.sh` erwarten `CARGO_HOME`/`RUSTUP_HOME` unter `~/tools/` — bei Standard-Installation die beiden Exporte in den Skripten anpassen.
+
+## Konfigurationslayout
+
+```
+~/.config/ai-control/
+├── settings.json                 App-Einstellungen (z. B. syncOnSessionEnd)
+├── projects.json                 Projekt-Registry: Name → Ordner
+└── pools/<pool>/                 je Pool ein Claude-Config-Verzeichnis
+    └── pool.json                 Name + Credential-Typ
+
+<projektordner>/                  beliebiger Pfad, per Registry gemappt
+├── .claude/                      Claude-Code-Projektkonfiguration
+└── ai-control.json               Pool-Zuordnung + Terminal-Einstellungen
+```