NYXOS

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 · Visuelle Seite · English version · Diese Seite als Markdown · 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.

Kurzfakten

FaktWert
NameNyxOS (die eingebaute KI heißt Nyx)
ArtLokales Entwickler-Werkzeug: Kommandozentrale für KI-Coding-Agenten
Beobachtete AgentenClaude Code und Codex (keine anderen Agenten-Programme)
PreisKostenlos. Kosten entstehen nur beim KI-Anbieter, den man ohnehin nutzt
LizenzMIT, © 2026 NyxOS contributors
Quellcodehttps://github.com/VariadAgency/NyxOs---Agentic-OS
PlattformenmacOS 13 oder neuer, Linux; x64 oder arm64. Kein Windows. WSL mit Einschränkungen
InstallationEin Befehl (siehe Ausprobieren)
Läuft alsEin 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 RechnerNur 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, TelemetrieKeine
DockerNicht nötig. Nur der optionale Server-Modus nutzt Docker Compose
Sprachen der OberflächeDeutsch und Englisch
Version0.1.0, veröffentlicht 2026-09-27
Seite aktualisiert2026-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.
  2. Installation mit einem Befehl (macOS oder Linux):
curl -fsSL https://raw.githubusercontent.com/VariadAgency/NyxOs---Agentic-OS/main/install.sh | bash
  1. 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/<version>.
  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:

NyxOS passt eher nicht, wenn:

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

Briefing, Rückblick und Vorlesen

Entscheidungen und Freigaben

Ü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

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

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

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

Stimme

Mitteilungen und Telegram

So funktioniert NyxOS

Was NyxOS außerhalb von ~/.nyxos ändert (nur mit Zustimmung bei der Einrichtung):

Lokal-Modus und Server-Modus

Lokal-Modus (Standard)Server-Modus (optional)
WoEin Node.js-Prozess auf deinem RechnerDocker Compose auf deinem eigenen Server oder VPS
DatenbankPGlite in ~/.nyxos/data/dbPostgreSQL-17-Container
Erreichbar unterNur 127.0.0.1:47800Auf dem Host nur an 127.0.0.1 veröffentlicht; Zugriff per SSH-Tunnel oder Tailscale
AnmeldungEinmal-Link aus nyxos openPasskeys (WebAuthn), eingerichtet mit einem Einmal-Code
Updatesnyxos update oder automatischgit 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)

Kommandozeile

BefehlWirkung
nyxos openNyxOS angemeldet im Browser öffnen (ohne Browser wird der Link ausgegeben)
nyxos statusVersion, Server-Zustand, Brücke, Datenort, Zahl der bekannten Transkripte
nyxos restart / nyxos stopServer und Brücke neu starten oder stoppen
nyxos logs [-f]Letzte 100 Zeilen der Server- und Brücken-Logs, oder live mitlesen
nyxos doctorPrü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 | removeLokale Stimme verwalten (etwa 1 GB)
nyxos uninstall [--purge]NyxOS entfernen; --purge löscht auch die Daten
nyxos versionInstallierte 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

Grenzen

Einordnung neben anderen Werkzeugen

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:

NyxOS passt nicht zu:

Ein Testlauf mit wenig Risiko:

  1. Die Online-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:

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.

Ü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.