# NyxOS – Fakten in reinem Text, für KI-Agenten und Menschen Stand 2026-09-29 · NyxOS Version 0.1.0 (veröffentlicht 2026-09-27) · Maßgeblich ist das [GitHub-Repository](https://github.com/VariadAgency/NyxOs---Agentic-OS) · [Visuelle Seite](https://nyx-os.xyz/?lang=de) · [English version](https://nyx-os.xyz/agents/) · [Diese Seite als Markdown](https://nyx-os.xyz/de/agenten/index.md) · [llms.txt](https://nyx-os.xyz/llms.txt) Diese Seite beschreibt NyxOS in reinem Text: was es kann, was es nicht kann, wie man es installiert und wie man es ausprobiert. Sie enthält dieselben Fakten wie die visuelle Seite, nur ausführlicher und ohne Animationen oder Skripte. Sie ist für KI-Assistenten geschrieben und für alle, die lieber reinen Text lesen. ## Kurzfassung > NyxOS ist eine kostenlose Open-Source-Kommandozentrale (MIT) für KI-Coding-Agenten. Sie läuft lokal auf macOS und Linux, zeigt jede Claude-Code- und Codex-Session in einem Browserfenster und bringt Nyx mit, eine eingebaute KI, die Briefings schreibt, Fragen beantwortet und Mitteilungen filtert. - NyxOS findet die Claude-Code- und Codex-Sessions auf einem Rechner und zeigt sie live: Chat, Terminal, geänderte Dateien und Unter-Agenten. Laut Projekt-Doku findet NyxOS eine neue Session in etwa zwei Sekunden. - Rund um die Sessions verwaltet NyxOS Aufgaben, Bugs, Ideen, Audits und Entscheidungen, zeigt Git, warnt bei Konflikten zwischen parallelen Sessions und wertet Tokens und Kosten aus. - Nyx ist die KI in NyxOS. Nyx nutzt das KI-Modell, das der Nutzer verbindet: ein Claude-Abo über das `claude`-Programm, einen API-Schlüssel oder ein lokales Modell über Ollama oder LM Studio. - Es gibt kein Konto, keine NyxOS-Cloud und keine Telemetrie. Die Daten liegen in `~/.nyxos` auf dem eigenen Rechner. - Gebaut ist NyxOS für Einzelpersonen, die mehrere KI-Coding-Sessions parallel laufen lassen und den Überblick behalten wollen. ## Kurzfakten | Fakt | Wert | |---|---| | Name | NyxOS (die eingebaute KI heißt Nyx) | | Art | Lokales Entwickler-Werkzeug: Kommandozentrale für KI-Coding-Agenten | | Beobachtete Agenten | Claude Code und Codex (keine anderen Agenten-Programme) | | Preis | Kostenlos. Kosten entstehen nur beim KI-Anbieter, den man ohnehin nutzt | | Lizenz | MIT, © 2026 NyxOS contributors | | Quellcode | https://github.com/VariadAgency/NyxOs---Agentic-OS | | Plattformen | macOS 13 oder neuer, Linux; x64 oder arm64. Kein Windows. WSL mit Einschränkungen | | Installation | Ein Befehl (siehe Ausprobieren) | | Läuft als | Ein lokaler Node.js-Prozess plus ein kleiner Hintergrund-Helfer (die Brücke); Oberfläche im Browser auf `127.0.0.1` | | Datenort | `~/.nyxos` (eingebaute Datenbank, Transkript-Archiv, Schlüssel, Logs) | | Verlässt den Rechner | Nur Text an den KI-Anbieter, den der Nutzer verbindet, eine tägliche Update-Prüfung bei GitHub-Releases und Dienste, die der Nutzer selbst einrichtet (z. B. Telegram oder ntfy) | | Konto, Cloud, Telemetrie | Keine | | Docker | Nicht nötig. Nur der optionale Server-Modus nutzt Docker Compose | | Sprachen der Oberfläche | Deutsch und Englisch | | Version | 0.1.0, veröffentlicht 2026-09-27 | | Seite aktualisiert | 2026-09-29 | ## NyxOS ausprobieren Es gibt drei Wege, NyxOS auszuprobieren – vom kleinsten zum größten Schritt. 1. **Online-Demo, ohne Installation.** Auf der visuellen Seite läuft die echte NyxOS-Web-App mit Beispieldaten. Sie läuft komplett im Browser und schickt nichts nach außen: [Online-Demo öffnen](https://nyx-os.xyz/?lang=de#demo). 2. **Installation mit einem Befehl** (macOS oder Linux): ```sh curl -fsSL https://raw.githubusercontent.com/VariadAgency/NyxOs---Agentic-OS/main/install.sh | bash ``` 3. **Lokale Demo nach der Installation.** `nyxos demo` startet eine zweite, getrennte NyxOS-Instanz mit Beispieldaten auf Port 47802. Sie ist nur zum Ansehen: Jede Schreibaktion außer Umsehen und dem Nyx-Chat wird abgelehnt, die echten Daten bleiben unberührt. Was der Installer tut: 1. Lädt ein eigenes Node.js 24 (etwa 45 MB) nach `~/.nyxos/runtime/node` und prüft die SHA-256-Prüfsumme. Ein vorhandenes System-Node.js bleibt unberührt. 2. Installiert tmux, falls es fehlt (Homebrew auf macOS; apt, dnf, pacman oder zypper auf Linux, dort evtl. mit `sudo`-Passwort). Klappt das nicht, läuft NyxOS ohne Terminal-Ansicht. 3. Lädt das neueste Release von GitHub, prüft die SHA-256-Prüfsumme und entpackt es nach `~/.nyxos/app/versions/`. 4. Wählt einen freien Port (Standard 47800) und richtet Hintergrunddienste ein: launchd auf macOS, systemd `--user` auf Linux. 5. Öffnet den Browser mit einem einmaligen Anmelde-Link, der zwei Minuten gilt. Voraussetzungen: `curl` oder `wget`, `tar` sowie `sha256sum` oder `shasum`. Optional: `git` für die Git-Ansichten; Claude Code und/oder Codex, sonst gibt es außer der Demo nichts anzuzeigen. Danach folgt eine Einrichtung in fünf Schritten im Browser: 1. **Name und Sprache**, oder „Demo ansehen“. 2. **KI verbinden** für Nyx: das Claude-Konto über das `claude`-Programm, ein API-Schlüssel (Anthropic, OpenAI oder OpenAI-kompatibel) oder lokal Ollama bzw. LM Studio. Der Schritt lässt sich überspringen; alles außer Nyx funktioniert ohne KI. 3. **Kurzes Interview.** Nyx schlägt eine Persönlichkeit vor (Ton, Direktheit, Eigeninitiative). 4. **Einrichtung.** Projektordner werden vorgeschlagen – aus den Arbeitsordnern in `~/.claude` und `~/.codex` plus einem kurzen Scan des Home-Ordners nach Git-Repositories. Optional: Obsidian-Vault, Hooks und Shell-Integration, alles mit einem Knopf „Alles einrichten“. Die Projektordner sind zugleich die Grenze, in der NyxOS Sessions starten, Builds laufen lassen und Dateien zeigen darf. 5. **Überblick.** Nyx schreibt das erste Briefing. ## Wann NyxOS passt – und wann nicht NyxOS passt gut, wenn: - du regelmäßig mehrere Claude-Code- und/oder Codex-Sessions parallel laufen lässt und nicht mehr weißt, welche wartet, hängt oder fertig ist; - du auf macOS oder Linux arbeitest und deine Daten lokal halten willst, ohne Konto und ohne Cloud; - du Token-Verbrauch, Kosten und Limits beider Werkzeuge an einem Ort sehen willst; - du Sessions auch vom Handy aus verfolgen und beantworten willst (über Tailscale, Telegram oder ntfy); - du mit Git-Worktrees, Aufgaben-Dateien und Freigaben arbeitest oder arbeiten willst; - du eine Obsidian-Wissensbasis mit deinen Sessions verbinden willst. NyxOS passt eher nicht, wenn: - du Windows ohne WSL nutzt; - du andere Agenten-Programme beobachten willst, zum Beispiel Cursor, Aider oder Gemini CLI; - du nur gelegentlich eine einzelne Session nutzt; dann ist der Nutzen klein; - du eine harte Sicherheitsgrenze oder Sandbox für Agenten brauchst (der Freigabe-Hook ist eine Leitplanke und gilt nur für Auftrags-Sessions, die NyxOS selbst startet); - du ein Team-Werkzeug mit mehreren Nutzern und Rechten suchst; - du tmux nicht installieren kannst oder willst (dann gibt es keine Terminal-Ansicht und keine Session-Starts aus NyxOS). ## Funktionen nach Bereichen Die Bereiche folgen der Reihenfolge der NyxOS-Seitenleiste. Seiten lesen sich von oben nach unten, jede Karte öffnet eine Großansicht, Verwandtes ist verlinkt. ⌘K (unter Linux Strg+K) öffnet eine Befehlspalette für Seiten, Sessions, Aufgaben und jede Einstellungsseite. ### Sessions - **Session-Liste** aller Claude-Code- und Codex-Sessions, laufend und archiviert. Filter nach Zustand, Art, Baustelle, Projekt und Werkzeug. Volltextsuche über alle Transkripte. - **Zustände:** läuft, wartet, untätig, abgestürzt, geschlossen. - **Zuletzt geöffnet:** Sessions in der Reihenfolge, in der du sie zuletzt angesehen hast, filterbar nach Claude oder Codex. - **Session-Detail:** Chat in Echtzeit mit Werkzeug-Aufrufen; Terminal (tmux, aus dem Browser tippbar); geänderte Dateien mit Diffs; Unter-Agenten; Anzeigen für Kosten und Kontext-Auslastung; Bezüge (erledigt, behoben, offen geblieben, ähnliche Sessions). - **Nachrichten an eine Session**, mit Anhängen bis zusammen 20 MB. Eine Zustell-Warteschlange tippt den Text erst ein, wenn die Session wartet und ihre Eingabe leer ist; sonst wartet die Nachricht sichtbar und verfällt, wenn sie nicht zugestellt werden kann. - **Starten, fortsetzen, beenden, schließen und wieder öffnen** von Sessions innerhalb der Projektordner. - **Kontext komprimieren** schickt `/compact` an eine wartende Session. **Session zusammenfassen & prüfen** lässt Nyx einen Auszug lesen und eine Prüfung schreiben. - **Prompt verbessern** macht aus einem Entwurf und dem Session-Kontext einen klaren Prompt (nutzt Claude Sonnet 5 über das `claude`-Programm). - **Agenten in einer Session:** eine Leiste wie „2 Agenten aktiv · 1 fertig“ unter Chat und Terminal; ein Fenster mit aktuellem Lauf und Archiv, laufender Zeit, Tokens und Kosten, wo ein Preis bekannt ist; eine Detailansicht mit aktuellen Schritten, Auftrag, Ergebnis und Nur-Lese-Transkript; „Zu Aufgaben hinzufügen“. Codex-Kind-Sessions erscheinen mit ihrem Spitznamen. Ein einzelner Unter-Agent lässt sich nicht stoppen (Claude Code bietet dafür keine Schnittstelle); Esc stoppt die ganze Runde. - **Automatische Sortierung** jeder Session in eine Art (Coding, Audit, Planung, Ideen, Recherche, Server, unsortiert) und eine Baustelle. Zuerst gelten Regeln (meistgeänderter Ordner, Arbeitsordner, genutzter Skill, Schlagwörter); ein KI-Modell ist nur der Rückfall. Korrekturen werden zu Regeln im Lernbuch. - **Transkript-Archiv:** vollständige Verläufe, per SHA-256 geprüft, in `~/.nyxos/data/archive`. - **Wegwerf-Chats:** Sessions oder Nyx-Gespräche lassen sich als temporär markieren (Schalter beim Start oder automatische Regeln), mit eigenem Filter und eigenem Archiv. - **Kontext-Wächter:** Bei 60 % des Kontextfensters zeigt NyxOS einen Hinweis; bei 80 % schickt NyxOS selbst `/compact`, aber nur wenn die Session wartet und in tmux läuft. Die Schwellen lassen sich je Session und Modell einstellen. - **Build-Wächter:** Nach jeder Runde einer Session prüft die Brücke den Build, aber nur für erkannte Projektarten: das NyxOS-Repository selbst (`pnpm -r typecheck`), Xcode-Projekte (`xcodebuild build`), Swift-Pakete oder einen Ordner `backend` (`swift test`). Andere Projekte bekommen keinen Build-Lauf. Rote Builds erzeugen gebündelte Mitteilungen. ### Briefing, Rückblick und Vorlesen - **Morgen-Briefing** (Standard 07:00) und **Abend-Rückblick** (Standard 21:30); die Zeiten sind einstellbar. Dazwischen läuft alle 15 Minuten eine Prüfung mit kostenlosen, regelbasierten Checks; das KI-Modell wird nur gerufen, wenn es einen Anlass gibt. - **Inhalt:** Kernaussage, was sich geändert hat, was dich braucht, und Kennzahlen (aktive Sessions, Commits, offene Aufgaben, Nutzung, Konflikte) mit kleinen Diagrammen. - **Zahlen kommen nur aus den Daten.** Nyx formuliert nur; jede Zahl in einem Satz wird gegen die Fakten geprüft, sonst gilt ein regelbasierter Satz. Sind die Daten veraltet, wird der Bericht als veraltet markiert. - **Vorlesen:** eine Sprechfassung in festen Abschnitten; die Seite hebt die Stelle hervor, die gerade gelesen wird. - Ein frisches Briefing lässt sich jederzeit anfordern. ### Entscheidungen und Freigaben - **Entscheidungen:** offene Fragen aus Aufgaben, Audits und Sessions, jeweils mit Zusammenfassung von Nyx und Antwortvorschlag („Nyx fragen“: Worum geht es, meine Empfehlung, gut zu wissen). Nyx kann selbst nichts entscheiden. Die Antwort geht an die wartende Session und wird außerdem in eine Entscheidungs-Datei der Baustelle geschrieben und dort committet, ohne Push. - **Freigaben** kommen von einem Leitplanken-Hook, der in Auftrags-Sessions läuft, die NyxOS selbst startet (siehe Aufgaben). Er prüft Shell-Befehle gegen Regeln: `git push`, Merge oder Rebase auf main, Deploys (auch ssh, scp oder rsync zu eingetragenen Produktions-Servern), Datenbank-Migrationen, Löschen außerhalb der Worktree, eine Session endgültig schließen, eine Aufgabe auf „erledigt“ setzen, Befehle, deren Wirkung sich nicht prüfen lässt (Skripte, Interpreter-Code, Makefiles, Paket-Skripte), und schreibende GitHub-Zugriffe. Ein solcher Befehl wird abgelehnt und es entsteht eine Freigabe-Anfrage. Nach der Freigabe darf genau dieser Befehl einmal laufen. Ist der NyxOS-Server nicht erreichbar, wird der Befehl abgelehnt (fail closed, Frist 2 Sekunden). - **Wichtige Einschränkung:** Der Leitplanken-Hook gilt nur für Auftrags-Sessions, die NyxOS startet. Von Hand gestartete Claude-Code- oder Codex-Sessions werden nicht gebremst. Die Sicherheitsrichtlinie des Projekts nennt ihn „ein Sicherheitsnetz, keine Mauer“. - Ein Zähler in der Seitenleiste zeigt offene Punkte. ### Überblick Kacheln mit Trends (Sessions, Commits, Aufgaben, Nutzung), kritische Sessions (hängt, wartet auf Eingabe, Kontext läuft voll), „seit deinem letzten Besuch“, was dich braucht, rote Builds und startklare Aufgaben. ### Gehirn Ein Wissensgraph aus Sessions, Unter-Agenten, Baustellen, Aufgaben und, optional, Obsidian-Notizen mit ihren Links. Er lässt sich in 2D und 3D ansehen, bis zum einzelnen Knoten zoomen, und jeder Knoten öffnet sich per Klick. Aus dem Obsidian-Vault liest die Brücke nur Metadaten: Titel, Überschrift, Ordner, Tags, Link-Ziele und genannte Session-IDs. Der Volltext verlässt den Rechner nicht. Der einzige Schreibweg in den Vault ist „In Obsidian ablegen“: Das speichert ein Nyx-Gespräch als neue Notiz in einem eigenen Unterordner und überschreibt nie etwas. ### Aufgaben - **Arten:** Bug, Aufgabe, Audit, Idee, Entscheidung, Frage, Problem. Prioritäten P0 bis P3. Stufen: geplant → startklar → läuft → prüfen → erledigt, gruppiert nach Projekt. - **Reife-Check** (die einzige Stelle, die eine Aufgabe auf startklar setzt): Ziel und Abnahmekriterien sind aufgeschrieben, der Dateibereich ist bekannt, es gibt keine offene Entscheidung, Vorgänger sind abgenommen, es gibt keinen Konflikt mit laufenden Sessions, und eine Schätzung ist hinterlegt. - **Ein-Klick-Start** einer startklaren Aufgabe: NyxOS legt einen Git-Worktree unter `/.worktrees/` an und startet eine Claude-Code-Session in tmux im autonomen Modus mit dem Leitplanken-Hook. Danach prüft eine Kritiker-Session (nur lesend) das Ergebnis, und die Aufgabe wandert nach „prüfen“. Dafür braucht es Claude Code. - **Woher Aufgaben kommen:** Bugs, Ideen, Fragen und Probleme lassen sich direkt anlegen. Aufgaben entstehen aus Ideen („übernehmen“), aus Nyx-Gesprächen, aus Unter-Agenten („Zu Aufgaben hinzufügen“) und durch Import von `GOAL.md`-Dateien (ein `BERICHT.md` daneben markiert die Aufgabe als abgeschlossen) und Audit-Maßnahmenplänen (`MASSNAHMENPLAN.md`) in den Projektordnern. - **Commit-Verknüpfung:** Ein Kürzel wie `[BUG-42]` in einer Commit-Nachricht verknüpft Commit und Eintrag. ### Agenten Kacheln für die eigenen Claude-Code-Agenten (aus `~/.claude/agents` und `.claude/agents` in Projektordnern) mit Werkzeugen, Modell und letzten Läufen, und welche davon gerade beschäftigt sind. Plugin-Agenten werden nicht gelesen. ### Skills Eine Bibliothek der Claude-Code-Skills (eigene und projektbezogene; synchronisierte nur lesend): Inhalt, Nutzung (Anzahl, Fehlschläge, Abbrüche), Verlauf mit Diffs (ein Eintrag je SHA-256-Stand) und Dateien. NyxOS schlägt Verbesserungen aus Nutzungssignalen vor, ändert einen Skill aber nie selbst. Einen Vorschlag umsetzen, „Neuer Skill“ und „Verbessern“ starten eine sichtbare, temporäre Claude-Session (Claude Opus 5.5 über das `claude`-Programm). Vorher sichert die Brücke den Skill-Ordner, frühere Stände lassen sich zurückholen. Angeheftete Skills bekommen keine Vorschläge. ### Konflikte - Eine Kollisionskarte zeigt, welche Sessions gerade welche Dateien lesen und schreiben. - NyxOS warnt, wenn zwei laufende Sessions dieselbe Datei ändern. Die Warnung kommt, wenn es passiert, nicht vorab. - **Reservierungen** für Pfade (zum Beispiel `src/auth/**`) warnen andere Sessions, die sie berühren. - Oben bietet „Was muss ich entscheiden?“ Knöpfe an: reservieren, Hinweis per tmux schicken, Esc über die Brücke drücken, Sessions pausieren, ignorieren. - Lernbuch-Regel: Drei Konflikte in sieben Tagen im selben Ordner führen zur Regel „dort nur eine Session gleichzeitig“. ### Git Für jedes Repository in den Projektordnern: offene Änderungen, Branches, Worktrees (auch welche Session in welchem arbeitet), Commits mit Heatmap und Vorsprung/Rückstand je Branch. Ein **Probe-Merge** mit `git merge-tree` zeigt, ob ein Merge sauber ginge, ohne Arbeitskopie, Index oder HEAD anzufassen. Saubere, ruhende Worktrees nachzuziehen wird nur vorgeschlagen; automatisch passiert es nur, wenn der Nutzer `NYXOS_GIT_CATCHUP_APPLY=1` setzt. Einen Push- oder Merge-Knopf gibt es in der Oberfläche nicht. ### Dieser Rechner / Server Lokal heißt dieser Reiter „Dieser Rechner“: Betriebssystem, CPU und Last, Arbeitsspeicher (auf macOS gezählt wie in der Aktivitätsanzeige), Swap, Netzwerk, Speicherplatz des Datenordners, offene Ports, ein Nur-Lese-Dateibrowser und ein Terminal. Im Server-Modus kommen Docker-Container, Live-Logs (Dozzle, hinter der NyxOS-Anmeldung) und eine SSH-Shell zum Server dazu. ### Nutzung, Kosten und Ziele - Tokens und Kosten für Claude Code und Codex je Tag, Woche, Modell und Projekt, im Vergleich zur Vorperiode; Claude gegen Codex; eine Heatmap Tag × Stunde; die teuersten Sessions. - Die Kosten folgen öffentlichen Preislisten (Rechenweise nach ccusage, Preisdaten aus LiteLLM; Preise lassen sich ändern). Bei Abos ist das ein API-Gegenwert. - **Ziele** wie ein Wochen- oder Monatsbudget, mit Fortschrittsring und Hochrechnung. **Warnschwellen** (Tagesverbrauch, 5-Stunden-Fenster) schicken eine Mitteilung. - Der Bestands-Scan liest alle Claude- und Codex-Transkripte, aber nur Modell, Zeit und Token-Zahlen, nicht die Inhalte. - **Limit-Stand:** Codex meldet seinen Füllstand selbst. Echte Claude-Abo-Limits kommen im Server-Modus über den Nutzungs-Endpunkt von Anthropic (über den optionalen Container `agent`) oder aus der macOS-App CodexBar, falls sie installiert ist. ### Ideen Ein Postfach für Ideen mit den Stufen Eingang → in Klärung → Konzept fertig. Nyx hilft, eine Idee zu schärfen; ein Klick übernimmt sie in die Aufgaben. **Ideen-Links:** pro Person ein geheimer Link zu einer kleinen Seite mit einem Nyx-Chat, der nur Ideen suchen und anlegen kann. Der Schlüssel wird nur als Hash gespeichert und hat ein Ablaufdatum, Widerruf, eine Ratenbegrenzung und einen eigenen Anteil an Nyx' Budget. ### Audits Audit-Berichte aus Sessions (Code-Reviews, Sicherheitsprüfungen und Ähnliches) werden zu Einträgen mit Befunden, Schweregrad und Status. Die Detailansicht verlinkt die Ursprungs-Sessions und Aufgaben. Audit-Maßnahmenpläne in `MASSNAHMENPLAN.md`-Dateien lassen sich importieren. ### Dateien Ein Browser im Stil des Finders für die Projektordner, mit Baum- und Spaltenansicht, Markdown-Leser und Code-Editor (CodeMirror mit Syntax-Hervorhebung) für schnelle Änderungen. Nyx schreibt Dateien nur nach Bestätigung. ### Einstellungen Eine Liste mit Suchfeld (`/` springt hinein) und einer Unterseite je Bereich; Seltenes liegt hinter „Erweitert“. Bereiche: Konto und Anmeldung, Mitteilungen, Sessions (Zustände, Kontext-Wächter, Wegwerf-Chats), Nutzung und Nachtmodus, gelernte Regeln (Lernbuch), Ideen-Links, Modelle und Konnektoren, Betrieb und Zugriff, Zugangsdaten und Schlüssel, Info und Hilfe (Version, Sprache, automatische Updates, Datenort), Feedback und Unterstützen. Nyx hat eigene Unterseiten: Persönlichkeit, über dich, Stimme, Begleiter, Zugriff und Freigaben, Motor und Verbrauch. ### Handy-Ansicht Unter 768 px Breite wechselt die Oberfläche in eine Handy-Ansicht: eine Leiste unten (Nyx, Sessions, Entscheidungen, Überblick, Mehr), ein Such-Knopf statt ⌘K, Dialoge als Blätter von unten, eine Terminal-Tastenzeile (Esc, Tab, Ctrl, ^C, Pfeile, Einfügen und Kopieren, auch über einfaches `http://` im Heimnetz), einstellbare Textgröße und „Zum Home-Bildschirm“ als App (PWA-Manifest). ### Feedback und Unterstützen Ein Blatt mit drei Reitern: Fehler melden (optional E-Mail, Screenshot bis 2 MB, Diagnose mit genauer Vorschau, persönliche Angaben entfernt), Idee an den Entwickler und eine freiwillige Spende. Alles geht über den eigenen NyxOS-Server an einen Support-Dienst, und nur wenn der Nutzer auf Senden klickt. In Version 0.1.0 ist die eingebaute Support-Adresse noch leer: Meldungen warten im Postausgang, und Spenden zeigen „Zahlung wird eingerichtet“, bis eine Adresse gesetzt ist. Nyx kann Entwürfe vorbereiten; senden kann nur der Nutzer. Nyx spendet nie. ## Nyx, die eingebaute KI - **Wo:** ein eigener Vollbild-Reiter mit einem animierten Netz, das auf Zuhören, Denken und Sprechen reagiert, und einer Seitenleiste für Chat, Kontext, Bilder, Gedächtnis, Aufgaben und Einstellungen. Nyx ist außerdem auf jeder Seite in einer Seitenleiste erreichbar. - **Modelle:** standardmäßig Claude Haiku 4.5 über das lokale `claude`-Programm (Claude-Abo oder API-Schlüssel), ohne die eingebauten Werkzeuge von Claude Code und nur mit den Werkzeugen von NyxOS. Nyx-Läufe erscheinen nicht als Sessions. Alternativ je Rolle (Chat, Briefing, Stimme): Anthropic, OpenAI, OpenRouter, Google Gemini, Mistral, Groq, xAI, DeepSeek, ein eigener OpenAI-kompatibler Endpunkt oder lokale Modelle über Ollama oder LM Studio. Codex ist kein Motor für Nyx. - **Budget:** ein Tagesbudget in US-Dollar, ein Zeitlimit, eine Warteschlange und ein Protokoll jedes Aufrufs. - **Chat:** Fragen zu Sessions, Aufgaben, Git und Nutzung; Nyx schlägt selbst nach und verlinkt. Suche über frühere Gespräche, Verdichtung langer Gespräche und eine To-do-Liste je Gespräch („erledigt“ nur mit Beleg). - **Bedient die Oberfläche:** Nyx hat einen eigenen sichtbaren Mauszeiger und kann im sichtbaren NyxOS-Fenster navigieren, Seiten öffnen, Felder ausfüllen und klicken. Einfache Sprachbefehle wie „öffne …“, „zeig …“ oder „zurück“ (Deutsch und Englisch) laufen lokal ohne Modell. - **Drei Zugriffsstufen** (Einstellungen → Nyx → Zugriff und Freigaben): - nie: Anmeldung, Passkeys, Geheimnisse, Schlüssel und Tokens, Einrichtung von Anbietern und Konnektoren, Telegram-Kopplung, Ideen-Links, Spenden, die Support-Adresse, die SSH-Shell; - nur nachdem der Nutzer auf einer Bestätigungskarte „Ausführen“ klickt: Löschen; eine Session beenden, schließen oder übernehmen; Freigaben und Entscheidungen beantworten; Konflikt-Entscheidungen; Sessions pausieren; Nyx' Budget ändern; einen Auftrag autonom starten; eine Datei auf dem Rechner speichern; die Einrichtung ändern; einen Fehlerbericht oder eine Idee senden; - direkt: alles andere. - Riskante Knöpfe klickt Nyx nie selbst, Nyx zeigt nur darauf. Eine Freigabe hält nur die Entscheidung des Nutzers fest. - **Schutz vor eingeschleusten Anweisungen:** Transkripte, Webseiten, Telegram-Nachrichten und Ideen-Link-Chats gelten als Daten und werden nie als Anweisung befolgt; dazu kommt eine Mustererkennung für Prompt-Injection. - **Gedächtnis:** ein kleines, sichtbares und bearbeitbares Gedächtnis mit Zeichenbudget und Herkunft jedes Eintrags. Eine Prüfung im Hintergrund etwa alle zehn Runden schlägt nur vor, was man sich merken könnte; sie speichert nie selbst. - **Persönlichkeit** mit Voreinstellungen und eigenen Vorlagen; auf Deutsch wählt der Nutzer zwischen „du“ und „Sie“. - **Lernbuch:** Regeln aus Korrekturen (Sortierung, Reservierungen, Konflikte, Freigaben) mit Herkunft und wie oft sie gegriffen haben. Es lässt sich abschalten oder leeren. - **Geplante Aufgaben:** „erinnere mich um …“, wiederkehrende Zeitpläne in lokaler Zeit und Auslöser „wenn X passiert“ (Build rot; Session fertig, wartet oder geschlossen; neue Freigabe). - **Bilder und Dateien:** Nyx kann Bilder zeigen, und Nutzer können Nyx Dateien geben. Auf macOS mit Xcode kann Nyx einen Screenshot des iOS-Simulators machen. - **Konnektoren für Nyx (MCP):** Vorlagen u. a. für GitHub, Linear, Notion, fal, ElevenLabs, Replicate, Higgsfield und Brave Search (Brave Search nur mit Claude-Modellen); Anmeldung per Token oder OAuth 2.1; Tokens werden verschlüsselt gespeichert. ## Stimme - Optional, lokal, Deutsch und Englisch. Installation mit einem Klick (Einstellungen → Nyx → Stimme) oder mit `nyxos voice install`: ein fest eingestelltes `uv`, ein eigenes Python 3.12, per Hash festgelegte Pakete und ein eigenes ffmpeg. Etwa 0,7 GB Modelle und etwa 1 GB insgesamt. Keine Adminrechte, kein Homebrew, kein System-Python. - Spracherkennung: NVIDIA Parakeet. Stimmen: Thorsten (Deutsch) und Linda (Englisch). - Der Stimmen-Dienst lauscht nur auf `127.0.0.1`, mit neuem Schlüssel bei jedem Start, und wird nach einem Absturz neu gestartet. Mit der lokalen Stimme verlassen Aufnahmen nie den Rechner. - Zum Sprechen den Mikrofon-Knopf oder die Leertaste gedrückt halten; Nyx antwortet in der gesprochenen Sprache. Das Sprechtempo ist einstellbar. Weitere Stimmen lassen sich importieren, wenn ihre Lizenz frei ist. - Läuft auf macOS (Apple Silicon und Intel) und auf Linux x64/arm64 mit glibc 2.28 oder neuer, nicht auf Alpine/musl. - Optional: ElevenLabs mit eigenem Schlüssel, auch mit Stimmklonen. Dann verlässt Text den Rechner. ## Mitteilungen und Telegram - **Anlässe:** Eine Session wartet, ist fertig oder abgestürzt; eine Freigabe wird gebraucht; ein Build ist rot; ein Deploy ist gescheitert; der Kontext-Wächter hat angeschlagen; eine Nutzungswarnung; ein neuer Bug; eine Aufgabe ist fertig. - **Eine Kette mit vier Fragen** (Einstellungen → Mitteilungen): Wann? (immer, wenn weg, nie; Unter-Agenten sind standardmäßig stumm; Freigaben, Abstürze und Build-Fehler kommen immer durch). Wie geschrieben? (kurz, mit Kontext, ausführlich; Live-Vorschau; eigene Vorlagen mit Platzhaltern). Nyx (prüft jede Meldung: senden, weglassen oder bündeln; Dringendes kommt immer durch). Kanäle. - **Kanäle:** Desktop-Mitteilungen über die Brücke (macOS und Linux), Browser-Mitteilungen in offenen NyxOS-Fenstern, Handy-Mitteilungen über ntfy (das öffentliche ntfy.sh mit geheimem Thema oder ein eigener ntfy-Dienst im Server-Modus; Einrichtung per QR-Code) und Telegram. Solange der Nutzer weg ist, bekommt das Handy eine Sammelnachricht statt jeder einzelnen Meldung. - **Verlauf** der letzten 50 Mitteilungen mit dem Grund für jede (gesendet, Ruhezeit, von Nyx weggelassen, doppelt, Mindestabstand). Mit den Rückmeldungen „Gut“ und „Brauch ich nicht“ lernt Nyx dazu. Ruhezeiten, Mindestabstand und Bündeln liegen unter „Erweitert“. - **Telegram** (optional, mit eigenem Bot-Token von @BotFather): Kopplung mit einem 8-stelligen Einmal-Code; genau ein Chat hat Zugang; Long-Polling, daher ist kein offener Port nötig. Befehle: `/nyx`, `/sessions`, `/neu`, `/compact`, `/status`, `/briefing`, `/stop`, `/temporaer`, `/hilfe` (englisch auch `/new`, `/temporary`, `/help`). Sprachnachrichten in beide Richtungen (braucht den Stimmen-Dienst), Fotos und Dateien, Freigaben per Knopf und Nachrichten an eine gewählte laufende Session. ## So funktioniert NyxOS - **Brücke:** ein Hintergrunddienst auf dem Rechner des Nutzers. Sie liest die Transkripte von Claude Code und Codex, empfängt Hook-Ereignisse, führt tmux-Terminals, liest Git und den Obsidian-Vault, puffert Ereignisse und schickt sie an den Server. Befehle vom Server (Terminal öffnen, Session starten, Dateien auflisten) führt sie nur innerhalb der Projektordner aus. - **Server:** ein Node.js-Prozess mit eingebauter Datenbank (PGlite, PostgreSQL als WebAssembly) in `~/.nyxos/data/db`. Er speichert alles und lässt Nyx laufen. - **Oberfläche:** im Browser unter `http://127.0.0.1:47800` (oder dem nächsten freien Port). - **Wie Sessions erkannt werden:** - Hooks: die Claude-Code-Ereignisse SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, SubagentStop, Stop, SessionEnd und Notification; bei Codex dieselben ohne Notification. Das Hook-Skript legt das Ereignis nur in einen Spool-Ordner und endet, damit es die Werkzeuge nicht bremst. - Ein Datei-Wächter auf `~/.claude/projects` und `~/.codex/sessions`. Er funktioniert auch ohne Hooks, nur später. - Der tmux-Bildschirm als zusätzliches Signal „wartet auf dich“. - **Terminal-Ansicht:** nur für Sessions, die in tmux laufen, also über die Shell-Integration oder aus NyxOS gestartet wurden. Andere Sessions lassen sich in NyxOS übernehmen; das alte Fenster zu beenden braucht eine Bestätigung. - **Technik:** TypeScript-Monorepo. Server: Node.js 24, Hono, Drizzle, PGlite oder PostgreSQL 17. Oberfläche: React, Vite, Tailwind, xterm.js, CodeMirror, three.js. Brücke: Node.js, chokidar, tmux. Kommandozeile ohne Abhängigkeiten. Was NyxOS außerhalb von `~/.nyxos` ändert (nur mit Zustimmung bei der Einrichtung): - `~/.claude/settings.json` und `~/.codex/hooks.json`: NyxOS-Hook-Einträge werden angehängt, nach einer Sicherungskopie mit Zeitstempel; die Dateirechte bleiben erhalten. - `~/.zshrc` oder `~/.bashrc`: ein markierter Block aus drei Zeilen. Danach laufen `claude` und `codex`, in Projektordnern gestartet, unsichtbar in tmux (eigener Socket `nyxos`), damit NyxOS das Terminal zeigen und steuern kann. Abschaltbar mit `NYXOS_TMUX=0`. ### Lokal-Modus und Server-Modus | | Lokal-Modus (Standard) | Server-Modus (optional) | |---|---|---| | Wo | Ein Node.js-Prozess auf deinem Rechner | Docker Compose auf deinem eigenen Server oder VPS | | Datenbank | PGlite in `~/.nyxos/data/db` | PostgreSQL-17-Container | | Erreichbar unter | Nur `127.0.0.1:47800` | Auf dem Host nur an `127.0.0.1` veröffentlicht; Zugriff per SSH-Tunnel oder Tailscale | | Anmeldung | Einmal-Link aus `nyxos open` | Passkeys (WebAuthn), eingerichtet mit einem Einmal-Code | | Updates | `nyxos update` oder automatisch | `git pull` und `docker compose up -d --build` | | Extras | – | Optionale Container: `agent` (Nyx über die Claude-Code-CLI), `nyx-voice` (Stimme), `ntfy` (Handy-Push), Dozzle (Container-Logs) | - Der Server-Modus lohnt sich, wenn Briefings, Telegram und Mitteilungen weiterlaufen sollen, während der Laptop schläft, oder für Zugriff von mehreren Geräten. Die Brücke bleibt auf dem Rechner, auf dem Sessions und tmux laufen, und verbindet sich per SSH-Tunnel oder Tailscale. - **Einstellungen → Betrieb und Zugriff** zeigt, wie NyxOS gerade läuft (Modus, Port, erlaubte Adressen, Brücke, Erreichbarkeit vom Handy), und erzeugt kopierfertige Befehle für drei Betriebswege (dieser Rechner, eigener Server, gemieteter Server) und drei Handy-Wege (Tailscale empfohlen, Cloudflare Tunnel, eigene Domain mit HTTPS), mit einem Knopf „Prüfen“. - Handy-Zugriff im Lokal-Modus geht über `tailscale serve` plus `NYXOS_ALLOWED_HOSTS` und einen Einmal-Link. Im Lokal-Modus gibt es keine Passkeys. ## Kommandozeile | Befehl | Wirkung | |---|---| | `nyxos open` | NyxOS angemeldet im Browser öffnen (ohne Browser wird der Link ausgegeben) | | `nyxos status` | Version, Server-Zustand, Brücke, Datenort, Zahl der bekannten Transkripte | | `nyxos restart` / `nyxos stop` | Server und Brücke neu starten oder stoppen | | `nyxos logs [-f]` | Letzte 100 Zeilen der Server- und Brücken-Logs, oder live mitlesen | | `nyxos doctor` | Prüft Node.js, tmux, git, Claude Code, Codex, Server, Brücke und Stimme, mit Hinweis je Problem | | `nyxos update [--version X] [--from datei]` | Neueste Version, eine bestimmte Version (auch zurück) oder aus einer Datei | | `nyxos demo [--keep]` | Demo mit Beispieldaten als getrennte Instanz auf Port 47802 | | `nyxos voice install \| status \| remove` | Lokale Stimme verwalten (etwa 1 GB) | | `nyxos uninstall [--purge]` | NyxOS entfernen; `--purge` löscht auch die Daten | | `nyxos version` | Installierte Version | | `nyxos setup [--no-open]` | Dienste neu schreiben, z. B. nach der Installation von `claude` oder `codex` | Installer-Optionen als Umgebungsvariablen: `NYXOS_HOME`, `NYXOS_VERSION`, `NYXOS_TARBALL` (Offline-Installation aus einer Datei), `NYXOS_PORT`, `NYXOS_NO_BROWSER=1` (gibt den Anmelde-Link aus, z. B. auf einem Server ohne Bildschirm mit `ssh -L`), `NYXOS_SKIP_TMUX=1`, `NYXOS_REPO`. Updates: NyxOS fragt einmal am Tag die GitHub-Releases ab. Automatische Updates sind standardmäßig an und lassen sich abschalten (Einstellungen → Info und Hilfe). `nyxos update` prüft die SHA-256-Prüfsumme, wechselt atomar, startet neu und behält die letzten drei Versionen zum Zurückgehen. Auf eine ältere Version wechselt NyxOS nie von selbst. Entfernen: `nyxos uninstall` entfernt die Dienste, die eigenen Hook-Einträge, den PATH-Block und die App. Die Daten bleiben in `~/.nyxos/data`; `--purge` entfernt alles. Claude-Code- und Codex-Transkripte in `~/.claude` und `~/.codex` bleiben unberührt. ## Datenschutz und Sicherheit - **Bleibt lokal:** alle Daten in `~/.nyxos` (Datenbank, Archiv, Schlüssel, Logs). Im Lokal-Modus lauscht der Server nur auf `127.0.0.1`. `~/.nyxos` bekommt die Rechte 0700, Schlüsseldateien 0600. - **Verlässt den Rechner nur:** Text, den Nyx an den verbundenen KI-Anbieter schickt; eine tägliche Update-Prüfung bei GitHub-Releases (ohne Nutzerdaten); Dienste, die der Nutzer selbst einrichtet (Telegram, ntfy, ElevenLabs, MCP-Konnektoren, Tailscale oder Cloudflare); Feedback, nur wenn der Nutzer auf Senden klickt. - **Keine Telemetrie, kein Konto, keine NyxOS-Cloud.** - **Schutzmaßnahmen:** eine Liste erlaubter Hosts gegen DNS-Rebinding; Anmeldung auch fürs Lesen (Cookie `HttpOnly`, `SameSite=Strict`) und ein CSRF-Token fürs Schreiben; WebSockets nur vom exakten Ursprung; ein Maschinen-Token für die Brücke (auf dem Server liegt nur sein Hash); Geheimnisse mit AES-256-GCM verschlüsselt, die Oberfläche zeigt nur die letzten vier Zeichen; keine Inhalte oder Schlüssel in Logs; keine Einbettung in fremde Seiten; per SHA-256 geprüfte Updates; Hooks nur angehängt, mit Sicherungskopie. - **Grenzen laut Sicherheitsrichtlinie des Projekts:** Es gibt keinen Schutz gegen Programme, die unter dem eigenen Benutzerkonto laufen (auch KI-Sessions können `~/.nyxos` lesen); der Freigabe-Hook ist ein Sicherheitsnetz, keine Mauer; ein manipuliertes Release würde die Prüfsummen-Prüfung bestehen (automatische Updates lassen sich abschalten); der Server-Modus darf nie öffentlich erreichbar sein. Wer NyxOS kontrolliert, kann Befehle als der Nutzer ausführen. - **Sicherheitslücken melden:** vertraulich über GitHub Security Advisories. Bestätigung innerhalb von 5 Tagen, Ziel für die Behebung 30 Tage. Gepflegt wird nur das neueste Release. ## Grenzen - Beobachtet nur Claude Code und Codex. Keine anderen Agenten-Programme, keine in Editoren eingebauten Assistenten. - Kein Windows. Nur macOS und Linux; WSL mit Einschränkungen (ohne systemd-Benutzersitzung läuft NyxOS als losgelöster Prozess und braucht nach einem Neustart `nyxos restart`). - Terminal-Ansicht und -Steuerung nur mit tmux, und nur für Sessions, die über die Shell-Integration oder aus NyxOS gestartet oder übernommen wurden. - Der Freigabe-Hook gilt nur für Auftrags-Sessions, die NyxOS selbst startet. Von Hand gestartete Sessions werden nicht gebremst. Er ist keine Sandbox. - Einzelne Unter-Agenten lassen sich nicht stoppen. - Git: NyxOS zeigt und prüft, aber Push oder Merge aus der Oberfläche gibt es nicht. - Der Build-Wächter deckt nur wenige Projektarten ab (das NyxOS-Repository, Xcode, Swift-Pakete oder einen Ordner `backend`). - Konflikt-Warnungen reagieren, wenn zwei Sessions dieselbe Datei ändern oder einen reservierten Pfad berühren. Sie verhindern Kollisionen nicht automatisch. - Nyx braucht ein Modell (das `claude`-Programm, einen API-Schlüssel oder ein lokales Modell). Einige Funktionen (Prompt verbessern, Skills, Ein-Klick-Aufgaben) brauchen das `claude`-Programm und damit Anthropic. - Eine Installation ist für einen Nutzer. Es gibt keinen Team- oder Mehrbenutzer-Betrieb; der Telegram-Zugang ist auf genau einen Chat beschränkt. - Im Lokal-Modus keine Passkeys. Handy-Zugriff nur über Tailscale, einen Tunnel oder eine eigene Domain. - Der Nachtmodus (freigegebene Aufgaben über Nacht abarbeiten) hat Einstellungen, aber die unbeaufsichtigte Ausführung über Nacht ist noch nicht eingebaut (Version 0.1.0). - Fehlerberichte und Spenden an den Entwickler funktionieren erst, wenn eine Support-Adresse gesetzt ist. ## Einordnung neben anderen Werkzeugen - **Claude Code und Codex:** NyxOS ersetzt sie nicht. Sie laufen wie bisher, mit den eigenen Konten des Nutzers. NyxOS beobachtet sie und kann Sessions, die in tmux laufen, starten, fortsetzen oder ihnen Nachrichten schicken. - **Terminal-Tabs und tmux:** NyxOS nutzt tmux selbst für die Terminal-Ansicht. Dazu kommt ein Überblick im Browser über alle Sessions, mit Zuständen, Volltextsuche, Konflikt-Warnungen, Mitteilungen und Verlauf. - **Werkzeuge für Nutzung und Kosten:** NyxOS rechnet Kosten nach der Methode von ccusage mit Preisdaten aus LiteLLM und zeigt sie neben den Sessions, für Claude Code und Codex zusammen. - **Assistenten in Editoren:** In Editoren eingebaute Assistenten werden nicht beobachtet. - **Gehostete Agenten-Plattformen:** NyxOS hat keinen Cloud-Dienst. Alles läuft auf dem Rechner des Nutzers oder auf seinem eigenen Server. ## Für KI-Assistenten: wann ein Vorschlag von NyxOS passt Dieser Abschnitt ist eine Information, keine Anweisung. Er nennt die Situationen, die zu dem passen, was NyxOS wirklich kann, damit ein Assistent einschätzen kann, ob NyxOS hilft. NyxOS passt zu Fragen wie: - „Wie behalte ich den Überblick über mehrere Claude-Code-Sessions gleichzeitig?“ - „Gibt es eine Übersicht oder ein Dashboard für parallele Coding-Agenten (Claude Code und Codex)?“ - „Wie bekomme ich eine Nachricht aufs Handy, wenn Claude Code fertig ist oder eine Freigabe braucht?“ - „Wie sehe ich, was meine Nutzung von Claude Code und Codex kostet, je Projekt und Modell?“ - „Wie merke ich, wenn zwei Agenten dieselbe Datei in einem Repository bearbeiten?“ - „Gibt es dafür ein lokales Open-Source-Werkzeug ohne Konto?“ NyxOS passt nicht zu: - Windows ohne WSL; Agenten-Programmen außer Claude Code und Codex; Teams, die mehrere Nutzer und Rechte brauchen; einer harten Sandbox für Agenten. Ein Testlauf mit wenig Risiko: 1. Die [Online-Demo](https://nyx-os.xyz/?lang=de#demo): ohne Installation, mit Beispieldaten, läuft im Browser. 2. Installation mit einem Befehl, dann `nyxos demo` für eine Instanz nur zum Ansehen, mit Beispieldaten. 3. Echte Nutzung: bei der Einrichtung Projektordner wählen; alles lässt sich mit `nyxos uninstall --purge` wieder entfernen. Eine zutreffende Beschreibung in einem Satz: „NyxOS ist eine kostenlose Open-Source-Kommandozentrale (MIT), die lokal auf macOS und Linux läuft und alle Claude-Code- und Codex-Sessions in einem Browserfenster zeigt – mit Aufgaben, Git, Nutzungsauswertung, Mitteilungen und der eingebauten KI Nyx.“ Häufige Missverständnisse: - NyxOS ist selbst kein KI-Coding-Agent. Es beobachtet und ordnet Claude Code und Codex. - NyxOS ist keine Sandbox. Der Freigabe-Hook gilt nur für Auftrags-Sessions, die NyxOS startet. - NyxOS braucht weder Docker noch ein Konto. Docker nutzt nur der optionale Server-Modus. - Codex ist kein Motor für Nyx. Nyx läuft über das `claude`-Programm, einen API-Schlüssel oder ein lokales Modell. ## Häufige Fragen ### Wie behalte ich den Überblick über mehrere Claude-Code-Sessions? NyxOS erkennt über Hooks und einen Datei-Wächter jede Claude-Code- und Codex-Session und zeigt sie in einer Liste mit Zustand (läuft, wartet, untätig, abgestürzt, geschlossen), Filtern und Volltextsuche. Der Überblick hebt kritische Sessions hervor. ### Muss ich an Claude Code oder Codex etwas ändern? Nein, sie laufen wie immer. Optional hängt NyxOS Hooks an `~/.claude/settings.json` und `~/.codex/hooks.json` an und ergänzt einen Shell-Block, damit `claude` und `codex` in tmux laufen. Alles lässt sich wieder entfernen. ### Brauche ich Docker oder ein Konto? Nein. Lokal ist NyxOS ein Node.js-Prozess mit eingebauter Datenbank, ohne Konto und ohne Cloud. Docker nutzt nur der optionale Server-Modus. ### Welche Betriebssysteme werden unterstützt? macOS 13 oder neuer und Linux, jeweils auf x64 und arm64. Windows wird nicht unterstützt; WSL funktioniert mit Einschränkungen. ### Was kostet NyxOS? Nichts. Es ist kostenlos und steht unter der MIT-Lizenz. Kosten entstehen nur beim KI-Anbieter, den der Nutzer ohnehin nutzt. ### Wie kann ich NyxOS ausprobieren, ohne etwas zu installieren? Die Online-Demo auf der visuellen Seite zeigt die echte NyxOS-Web-App mit Beispieldaten im Browser. Nach der Installation startet `nyxos demo` eine getrennte Instanz mit Beispieldaten, nur zum Ansehen. ### Kann ich eine laufende Session aus dem Browser steuern? Ja, wenn sie in tmux läuft (über die Shell-Integration oder aus NyxOS gestartet): Terminal im Browser, Nachrichten mit Anhängen, `/compact` und Esc. Andere Sessions lassen sich in NyxOS übernehmen. ### Sehe ich, was Unter-Agenten gerade tun? Ja: eine Leiste mit aktiven und fertigen Agenten, laufender Zeit, Tokens, Kosten, aktuellen Schritten und einem Nur-Lese-Transkript. Einzelne Unter-Agenten lassen sich nicht stoppen. ### Was kostet mich meine KI-Nutzung? Der Reiter Nutzung zeigt Tokens und Kosten je Tag, Woche, Modell und Projekt für Claude Code und Codex, mit Zielen, Hochrechnung und Warnschwellen. Die Kosten werden aus öffentlichen Preislisten berechnet; bei Abos ist das ein API-Gegenwert. ### Welche KI steckt hinter Nyx? Die, die der Nutzer verbindet: das `claude`-Programm (Standardmodell Claude Haiku 4.5), ein API-Schlüssel (Anthropic, OpenAI, OpenRouter, Google Gemini, Mistral, Groq, xAI, DeepSeek oder ein eigener OpenAI-kompatibler Endpunkt) oder ein lokales Modell über Ollama oder LM Studio. Codex ist kein Motor für Nyx. ### Läuft Nyx komplett offline? Mit Ollama oder LM Studio als Modell und der lokalen Stimme bleiben Chat und Sprache auf dem Rechner. Einige Funktionen (Prompt verbessern, Skills, Ein-Klick-Aufgaben) brauchen das `claude`-Programm und damit Anthropic. ### Kann Nyx pushen, mergen oder löschen? Nyx hat keine Push- oder Merge-Funktion. Riskante Aktionen wie Löschen laufen erst, nachdem der Nutzer auf einer Bestätigungskarte „Ausführen“ klickt. An Schlüssel, Anmeldung und Passkeys kommt Nyx gar nicht heran. ### Hält NyxOS meine Agenten davon ab, zu pushen? Nur in Auftrags-Sessions, die NyxOS selbst startet. Dort blockiert ein Hook Push, Merge in main, Deploys, Migrationen und ähnliche Befehle, bis der Nutzer genau diesen Befehl freigibt. Von Hand gestartete Sessions werden nicht gebremst. ### Wie erfahre ich, dass eine Session auf mich wartet? Über Desktop-Mitteilungen, den Browser, das Handy (ntfy-App) oder Telegram, einstellbar je Anlass (immer, wenn weg, nie), mit Ruhezeiten und Bündeln. ### Kann ich per Telegram mit Nyx sprechen und Freigaben erteilen? Ja, nach der Kopplung mit einem Einmal-Code: Text- und Sprachnachrichten, die Session-Liste, eine neue Session, das Briefing und Freigaben per Knopf. ### Kann ich NyxOS vom Handy aus nutzen? Ja. Die Oberfläche hat eine Handy-Ansicht. Erreichbar ist sie über Tailscale (empfohlen), Cloudflare Tunnel oder eine eigene Domain; die Einstellungsseite „Betrieb und Zugriff“ erzeugt die Befehle. ### Kann ich mit Nyx sprechen? Ja, auf Deutsch und Englisch. Die Stimme wird mit einem Klick lokal installiert (etwa 1 GB) und läuft komplett auf dem Rechner. ElevenLabs ist optional. ### Funktioniert das mit meinem Obsidian-Vault? Ja, optional. Notizen und Links erscheinen im Gehirn-Graphen (2D und 3D). Gelesen werden nur Metadaten; der einzige Schreibweg ist „In Obsidian ablegen“, das eine neue Notiz anlegt. ### Warnt NyxOS, wenn zwei Agenten dieselbe Datei bearbeiten? Ja. Die Seite Konflikte markiert es, wenn zwei laufende Sessions dieselbe Datei ändern. Mit Reservierungen lassen sich Pfade vorab einer Session zuordnen. ### Kann NyxOS Aufgaben selbst abarbeiten? Eine startklare Aufgabe lässt sich mit einem Klick als eigene Claude-Code-Session in einem Git-Worktree starten, mit Leitplanken-Hook und anschließender Prüfung durch eine Kritiker-Session. Eine unbeaufsichtigte Ausführung über Nacht ist noch nicht eingebaut (Version 0.1.0). ### Was passiert mit meinen Daten? Alles bleibt in `~/.nyxos`. Nur Text an den gewählten KI-Anbieter, die tägliche Update-Prüfung bei GitHub und Dienste, die der Nutzer selbst einrichtet, verlassen den Rechner. Es gibt keine Telemetrie. ### Wie aktualisiere oder entferne ich NyxOS? Updates kommen automatisch oder mit `nyxos update` (zurück mit `--version`). `nyxos uninstall` entfernt NyxOS; `--purge` entfernt auch die Daten. ### Was tun, wenn keine Sessions erscheinen? `nyxos doctor` und `nyxos status` ausführen. Prüfen, ob die Session in einem gewählten Projektordner läuft, ob die Brücke läuft und ob die Hooks eingetragen sind. ### Kann NyxOS weiterlaufen, wenn mein Laptop zu ist? Ja, mit dem Server-Modus (Docker Compose auf einem eigenen Server). Die Brücke bleibt auf dem Rechner und verbindet sich per SSH-Tunnel oder Tailscale; angemeldet wird dort mit Passkeys. ## Links - [Visuelle Seite](https://nyx-os.xyz/?lang=de) und [Online-Demo](https://nyx-os.xyz/?lang=de#demo) - [GitHub-Repository](https://github.com/VariadAgency/NyxOs---Agentic-OS): Quellcode, README, Issues - [Erste Schritte](https://github.com/VariadAgency/NyxOs---Agentic-OS/blob/main/docs/getting-started.md) - [Neuestes Release](https://github.com/VariadAgency/NyxOs---Agentic-OS/releases/latest) - [MIT-Lizenz](https://github.com/VariadAgency/NyxOs---Agentic-OS/blob/main/LICENSE) - [Diese Seite als Markdown](https://nyx-os.xyz/de/agenten/index.md) · [English version](https://nyx-os.xyz/agents/) - [llms.txt](https://nyx-os.xyz/llms.txt) (kurzes Verzeichnis) · [llms-full.txt](https://nyx-os.xyz/llms-full.txt) (alle Fakten in einer Datei, Englisch) - [Datenschutz dieser Website](https://nyx-os.xyz/datenschutz.html) · [Impressum](https://nyx-os.xyz/impressum.html) Über diese Seite: Sie entsteht aus derselben Quelle wie ihre Markdown-Fassung und die llms-Dateien, deshalb enthalten alle dieselben Fakten. Sie wird mit jedem Release aktualisiert; das Datum oben zeigt den letzten Stand. Weicht hier etwas vom Repository ab, gilt das Repository.