Discord Presence für Claude Desktop, Codex und Antigravity

Eine Discord-Aktivität für drei Coding-Agenten. Zeigt, womit du gerade arbeitest – Claude Desktop, OpenAI Codex oder Google Antigravity – mit Modell, Tätigkeit, Auslastung, Abonnement und Timer. Arbeiten mehrere gleichzeitig, wechselt die Anzeige alle 20 Sekunden zwischen ihnen. Wer nur offen ist und wartet, bleibt draußen.

Inoffizielles Projekt, weder von Anthropic noch von OpenAI, Google oder Discord. Windows und Linux.

Nur Claude Desktop?

Diese Fassung führt Claude Desktop, OpenAI Codex und Google Antigravity in einer Aktivität zusammen. Wer allein mit Claude Desktop arbeitet und nichts weiter einrichten möchte, nimmt v1.4.4: die letzte Fassung vor dem Beacon-Pool, eine reine Claude-Desktop-Erweiterung, Installation durch Doppelklick auf die .mcpb-Datei. Sie wird nicht mehr weiterentwickelt, läuft aber unverändert weiter.

Ab Fassung 1.5.0 kommen die beiden anderen Agenten dazu. Seither sendet ein eigenständiger Dienst an Discord statt der Erweiterung, und die Connectoren für Codex und Antigravity liegen in connectors/ im selben Klon.

Related MCP server: Clarik Mcp Server

Was in Discord steht

Discord zeigt zwei Zeilen. Die erste sagt ohne Verzögerung, was gerade passiert: „Claude denkt nach", „OpenAI Codex · editing a Python file", „Google Antigravity · running tests". Die zweite rotiert durch das, was sich nur langsam ändert: Modell, Auslastung, Abonnement. Beide Zeilen stammen immer vom selben Agenten – die Tätigkeit des einen steht nie über dem Modell des anderen.

Was nie dort steht: Chatinhalte, Chattitel, Dateinamen, Pfade, Befehle, Suchanfragen. Die Art der bearbeiteten Datei („a Python file") kommt aus einer geschlossenen Liste von 21 Marken, in der sich ein Name gar nicht ausdrücken lässt. Dafür gibt es keinen Schalter, weil es keinen braucht: was nicht erhoben wird, kann nicht versehentlich im Profil landen.

Wie es zusammenspielt

Genau ein Prozess sendet an Discord, der Sender. Codex und Antigravity melden ihm ihren Zustand über kleine JSON-Dateien im Datenordner, die Beacons; das Format steht in docs/SPEC-beacon-v1.md. Der Sender läuft als eigenständiger Dienst (standalone/) oder als Erweiterung in Claude Desktop (mcpb/). Laufen beide, hat der Dienst Vorrang, und die Erweiterung weicht binnen einer Minute – fällt der Dienst aus, übernimmt sie wieder. Wie das funktioniert, steht in ARCHITEKTUR.md.

Kein Teil ruft eine Anbieter-Schnittstelle auf, liest ein Token, ein Cookie oder einen Schlüsselbund. Alles kommt aus lokalen Dateien oder aus dem Fenster der jeweiligen Anwendung.

Installation

Windows

Voraussetzung: Python 3.9 oder neuer von python.org – nicht aus dem Microsoft Store. Store-Apps bekommen einen umgeleiteten Datenordner; damit schreiben Sender und Connectoren an verschiedene Stellen und sehen einander nie. setup_venv.bat und standalone\install.ps1 prüfen das.

git clone https://github.com/Arikazei/CDRP-for-Claude.git
cd CDRP-for-Claude
setup_venv.bat
powershell -ExecutionPolicy Bypass -File standalone\install.ps1

setup_venv.bat legt .venv an, installiert die Abhängigkeiten und kopiert config.example.json nach config.json. install.ps1 richtet drei Autostart-Einträge ein (Dienst, Codex-Wächter, Antigravity-Wächter), erzeugt die Codex-Hook-Dateien und startet alles sofort. Im Task-Manager stehen die drei Einträge unter „Autostart" und lassen sich dort abschalten.

Dann Codex einmalig anbinden, in einem Terminal, in dem codex erreichbar ist (die Desktop-App bringt es mit):

codex plugin marketplace add "<Repo>\connectors\codex\plugin"
codex plugin add codex-discord-presence@personal

Danach in der Codex-App /hooks öffnen und die sieben Hooks als vertrauenswürdig bestätigen. Ohne diese Bestätigung werden sie nicht ausgeführt, und die App zeigt sie bis dahin unter Umständen gar nicht an. Bereits laufende Codex-Aufgaben übernehmen neue Hooks nicht; eine neue Aufgabe starten. Einzelheiten und der Weg ohne Plugin: connectors/codex/README.md.

Antigravity braucht nichts weiter: der Wächter findet das Transkript unter ~\.gemini\antigravity von selbst.

Linux

Voraussetzung: python3 ab 3.9, dazu pypresence und jeepney:

git clone https://github.com/Arikazei/CDRP-for-Claude.git
cd CDRP-for-Claude
python3 -m pip install --user pypresence jeepney
cp config.example.json config.json
standalone/install.sh

install.sh legt drei systemd-Benutzerdienste an (claude-discord-presence, -codex, -antigravity), erzeugt die Codex-Hook-Dateien und startet alles. Codex wird wie unter Windows angebunden; alternativ genügt es, den Inhalt von ~/.local/share/ClaudeDiscordPresence/codex-hooks.json nach ~/.codex/hooks.json zu übernehmen.

Abo und Auslastung von Codex und Antigravity werden unter Linux nicht gelesen – dafür fehlt die Fensterschnittstelle, UI Automation gibt es nur unter Windows. Tätigkeit und Modell funktionieren. Fokus, Leerlauf und Bildschirmleser: siehe Linux.

Nur die Claude-Erweiterung

Wer keinen Dienst will, installiert nur die .mcpb aus den Releases in Claude Desktop. Dann läuft die Presence, solange Claude Desktop läuft; Codex und Antigravity erscheinen trotzdem, sofern ihre Wächter und Hooks eingerichtet sind (siehe oben).

Ein Doppelklick auf die .mcpb funktioniert nicht – Claude Desktop meldet für diese Endung keine Dateizuordnung an. Installiert wird über das Entwickler-Menü:

1. Entwickler-Menü freischalten mit dem Inhalt {"allowDevTools": true}:

   System	Pfad
   Windows	%APPDATA%\Claude\developer_settings.json
   Linux	~/.config/Claude/developer_settings.json

   Ohne BOM speichern. Schreibt der Editor eine Byte-Order-Mark an den Anfang, startet Claude mit „Entwicklereinstellungen konnten nicht geladen werden". Unter Windows also nicht mit Set-Content -Encoding UTF8, sondern:

   [System.IO.File]::WriteAllText("$env:APPDATA\Claude\developer_settings.json",
     '{"allowDevTools": true}', (New-Object System.Text.UTF8Encoding $false))

2. Claude Desktop komplett beenden – unter Windows auch das Symbol im Infobereich neben der Uhr – und neu starten.

3. Menüleiste öffnen (Windows: einmal Alt drücken, sie ist ausgeblendet): Entwickler → Erweiterungen → Erweiterung installieren…, die .mcpb auswählen, Rückfrage bestätigen.

Deinstallieren geht über Einstellungen → Erweiterungen; verweigert die Oberfläche das, hilft tools/remove_extension.ps1 bei geschlossener App. Unter Linux werden zusätzlich Claude Desktop für Linux (Beta, Ubuntu 22.04+ oder Debian 12+) und ein python3 ab 3.9 vorausgesetzt; dasselbe Paket dient beiden Systemen. Es wird nichts kompiliert: das Paket enthält Pythons offizielles Embeddable Package und ausschließlich reine Python-Bibliotheken – keine SmartScreen-Warnung, keine typischen Virenscanner-Fehlalarme.

Entfernen

standalone\uninstall.ps1 beziehungsweise standalone/uninstall.sh nimmt Autostart-Einträge beziehungsweise Dienste zurück und beendet die Prozesse. Die Codex-Hooks bleiben registriert; abschalten lassen sie sich in Codex über das Plugin.

Eigene Discord-Anwendung (optional)

Ohne weitere Angaben läuft alles über die mitgelieferte Anwendung – dann erscheinen deren Name und Bild in deinem Profil. Für einen eigenen Namen und ein eigenes Bild: im Developer Portal New Application anlegen, unter Rich Presence → Art Assets ein Bild mit dem Namen logo hochladen und die Application ID in den Einstellungen eintragen. Der Asset-Name muss exakt mit large_image_key aus der Konfiguration übereinstimmen, sonst zeigt Discord die Presence ohne Bild. „Claude" ist als App-Name bei Discord gesperrt.

Einstellungen

Läuft die Erweiterung, kommen die Einstellungen aus Claude Desktop → Einstellungen → Erweiterungen → „Discord Presence for Claude Desktop". Die Felder erzeugt Claude Desktop selbst aus dem Manifest – eine eigene Oberfläche hat das Projekt bewusst nicht.

Der Dienst liest dieselben Werte: er nimmt die jüngste config.json aus allen Datenordner-Kandidaten (siehe unten), damit Dialog und Dienst nie auseinanderlaufen. Wer aus dem Quelltext läuft und keine Erweiterung hat, bearbeitet config.json im Projektordner. Dort gibt es mehr Stellschrauben als im Dialog, etwa client_plans (Abo-Text für Codex und Antigravity, falls das Fenster nicht gelesen werden kann) und state_line (Rotation oder Verkettung der zweiten Zeile).

Wo Konfiguration, Protokoll und Beacons liegen

Darin liegen config.json, standalone.log (Dienst), claude_rpc.log (Erweiterung), state.json (was gerade gesendet wird), sender.<rolle>.json (wer gerade sendet), beacons/<slug>.json (ein Beacon je Agent) und die erzeugten Codex-Dateien codex-hook.cmd beziehungsweise .sh und codex-hooks.json. Die Umgebungsvariable CLAUDE_RPC_DATA_DIR lenkt alles um.

Unter Windows kennt das Projekt bewusst mehrere Kandidatenordner: Anwendungen aus dem Microsoft Store – die Store-Fassung von Claude Desktop ebenso wie das Store-Python – bekommen %LOCALAPPDATA% still nach %LOCALAPPDATA%\Packages\<Paket>\LocalCache\Local\ umgeleitet. Der Sender liest deshalb aus seinem eigenen Ordner, aus dem Profilpfad oben und aus jedem Packages\Claude_*-Ordner; die Produzenten schreiben immer in den Profilpfad, denn %USERPROFILE% wird nie umgeleitet.

Im Task-Manager heißen Dienst und Wächter pythonw.exe, die Erweiterung ClaudeDiscordPresence.exe; unter Linux ist alles python3.

Bei Fassungen der Erweiterung bis einschließlich 1.4.2 lag der Datenordner woanders. Das Manifest meldete damals server.type: "python", und Claude Desktop startete die Erweiterung mit dem python3 aus dem PATH – war das das Store-Python, landeten die Dateien unter %LOCALAPPDATA%\Packages\PythonSoftwareFoundation.Python.3.12_*\LocalCache\Local\ClaudeDiscordPresence\. Ab 1.4.3 meldet das Manifest "binary". Wer von einer älteren Fassung kommt, darf den alten Ordner löschen – er wird nicht mehr gelesen.

Was gelesen wird

Alles lokal. An Discord gehen nur Statustext, Modell beziehungsweise Tätigkeit, Dateiart, Auslastung in Prozent und die Abo-Bezeichnung.

• Claude-Fenster über die Barrierefreiheitsschnittstelle des Systems (Windows UI Automation, Linux AT-SPI): Modellname und die Statuszeile am Eingabefeld. Nur dieses eine Fenster – kein globaler Hook, keine Tastatur- oder Mausaufzeichnung, kein Fokuswechsel.

• Desktop Commander: ~/.claude-server-commander/tool-history.jsonl, ausschließlich das Feld toolName. Argumente und Ausgaben stehen in derselben Datei und werden bewusst ignoriert.

• Claude Desktop: Sitzungsdateien lokaler Cowork-Sessions und die Nutzungsdatei plan-usage-history.json. Übernommen werden nur Sitzungs-, Wochen- und Modell-Limits – der Balken für das Nutzungsguthaben und der ausgegebene Betrag bleiben ausdrücklich außen vor.

• Codex-Hooks: die Nutzlast, die Codex jedem Hook übergibt. Ausgewertet werden hook_event_name, tool_name, model (nur, wenn der Wert wie ein Modellname aussieht: Buchstaben, Ziffern, Punkt, Bindestrich, Unterstrich, Leerzeichen, höchstens 40 Zeichen) und die Endung expliziter Pfadfelder. Prompt, Arbeitsverzeichnis, Sitzungskennung und Transkriptpfad liegen in derselben Nutzlast und werden verworfen.

• Antigravity: ~/.gemini/antigravity/brain/<id>/.system_generated/logs/transcript.jsonl. Ausgewertet werden type, der Name des ersten Werkzeugaufrufs und die Endung seines Pfadarguments. content und thinking werden nicht gelesen.

• Fenster von Codex und Antigravity (nur Windows, nur solange die Einstellungen offen sind): Abo-Name und Prozentwerte, und nur, was auf ein festes Muster passt. Der Fensterbaum enthält den ganzen Editorinhalt; frei gelesen wird darin nichts.

• Systemweit nur: läuft das Programm, ist Claude im Vordergrund, wann war die letzte Eingabe. Zeitstempel und Prozessnamen, keine Inhalte.

Chat-Titel werden gar nicht erst erhoben – nicht abschaltbar, weil es dafür keinen Schalter braucht.

Es wird kein Anmelde-Token gelesen und kein Anbieter-Endpunkt aufgerufen. Anthropic untersagt seit Februar 2026 die Verwendung von OAuth-Token aus Free-, Pro- oder Max-Konten in anderen Produkten; dieses Projekt hält sich davon vollständig fern, und für Codex und Antigravity gilt dieselbe Regel.

Zur Auslastung: 5-Stunden- und Wochenwert von Claude stehen in einer Datei, die Claude Desktop selbst alle fünf Minuten fortschreibt. Alles andere – das modellspezifische Wochenlimit bei Claude, Abo und Limits bei Codex und Antigravity – wird nur abgelesen, während das jeweilige Nutzungsfenster offen ist, altert danach sichtbar („Fable 99 % (vor 2 h)") und verschwindet nach drei Stunden. Lieber keine Zahl als eine falsche.

Linux

Vollständig unterstützt ab v1.4.0. Weil kein Weg zu Fokus und Leerlaufzeit überall vorhanden ist, probiert linuxdesktop.py sechs gängige der Reihe nach durch und behält den ersten, der antwortet; welche das sind und warum, steht in ARCHITEKTUR.md. Trägt keiner, bleibt die Presence sichtbar, solange Claude läuft – sie schaltet dann nur nicht mehr auf „abwesend".

Eine Bedingung stellt Chromium: Seiteninhalt veröffentlicht es nur, wenn ein Bildschirmleser angemeldet ist. Der Daemon meldet deshalb beim Start einen an (ui_watcher.announce_screen_reader) – das wirkt erst beim nächsten Start von Claude. Bleibt der Baum danach beim Fenstergerüst aus vier Knoten (das Protokoll sagt es), hilft --force-renderer-accessibility:

cp /usr/share/applications/com.anthropic.Claude.desktop ~/.local/share/applications/
sed -i 's|^Exec=claude-desktop|Exec=claude-desktop --force-renderer-accessibility|' \
  ~/.local/share/applications/com.anthropic.Claude.desktop

Was dein Rechner hergibt, sagt das Diagnoseprogramm:

python3 tools/atspi_dump.py

Erkannt wird der Prozess claude-desktop. Der nackte Name claude gehört der Kommandozeilenfassung und ist bewusst ausgeschlossen. Heißt der Hauptprozess bei dir anders, trägst du ihn unter process_names ein – das Protokoll nennt bei Nichterkennung stündlich alle gefundenen Kandidaten samt Pfad. Die Wächter erkennen codex/chatgpt und antigravity über /proc.

Entwicklung

setup_venv.bat                                     :: venv + config.json aus config.example.json
.venv\Scripts\python -m unittest tools.test_beacons tools.test_stufe connectors/antigravity/test_watcher.py
cd connectors\codex && ..\..\.venv\Scripts\python -m unittest test_codex_beacon
.venv\Scripts\python tools\probe_codex_hook.py     :: Codex-Hook mit synthetischen Ereignissen, Wegwerfordner
.venv\Scripts\python tools\validate_beacon.py codex :: einen echten Beacon gegen den Vertrag pruefen
powershell -File standalone\neustart.ps1           :: Dienst, Waechter und Erweiterung neu starten
powershell -File build_mcpb.ps1                    :: dist\*.mcpb bauen

Die eigene config.json bleibt bewusst untracked; Vorlage ist config.example.json. Diese Vorlage ist zugleich die Quelle, aus der make_default_config.py die ausgelieferte config.default.json erzeugt – neue Schlüssel gehören also nach config.example.json, sonst fehlen sie im Paket. Sie wird von Hand gepflegt und darf nichts Persönliches enthalten; App-ID, Knöpfe, Prozessnamen und Abo-Text werden beim Bauen zusätzlich zurückgesetzt.

Die Hook-Dateien unter connectors/codex/ sind Vorlagen mit Platzhaltern; connectors/codex/install_hooks.py füllt sie aus. Die erzeugte plugin/.../hooks.json ist untracked, damit nie ein Rechnerpfad ins Repo gerät.

Für den Betrieb aus dem Quelltext nicht das Microsoft-Store-Python verwenden. Store-Apps bekommen ein umgeleitetes %APPDATA% und %LOCALAPPDATA%; das Skript sieht dann weder %APPDATA%\Claude noch den Datenordner der anderen. _check_env.py prüft das. Als installierte Erweiterung entscheidet Claude Desktop das leider selbst – siehe „Wo Konfiguration, Protokoll und Beacons liegen".

Der Build bricht ab, sobald eine Abhängigkeit eine .pyd oder .dll mitbringt – das hält das Paket signaturfrei.

Lizenz

MIT