Cookbox.ai Doku — Überblick

Cookbox.ai ist eine Android-Steuerung für Claude Code, Codex, Cursor und einfache Shell-Sitzungen auf Rechnern, die dir bereits gehören. Die Verbindung läuft direkt über SSH. Es gibt kein Cookbox-Konto und kein Cookbox-Relay.

Was wo läuft

Nichts von dir läuft auf unserer Infrastruktur. Der Agent, der Multiplexer und dein Code bleiben auf deinem Rechner; das Telefon ist ein Client, der sich damit verbindet und zeigt, was dort passiert.

Teil	Läuft auf	Aufgabe
Cookbox.ai-App	Dein Android-Telefon	Verwahrt die SSH-Schlüssel, zeichnet die Terminals, meldet sich, wenn ein Durchgang endet.
tmux oder zellij	Dein Rechner	Hält Sitzungen zwischen Verbindungen am Leben, sodass das Schließen der App nichts beendet.
Claude Code, Codex, Cursor	Dein Rechner	Erledigt die Arbeit, mit deinem eigenen Abonnement und deinen Zugangsdaten.
`mps` (moshpit)	Dein Rechner, optional	UDP-Transport mit lokalem Echo, damit Tippen eine schwache Verbindung und einen Netzwechsel übersteht.

Was die App kann

Speichert SSH-Rechner und Schlüssel, merkt sich jeden Host-Schlüssel beim ersten Mal und verweigert einen geänderten.
Listet, erstellt, benennt um, setzt fort, trennt und schließt tmux- und zellij-Sitzungen.
Zeigt, was jeder Agent gerade tut — arbeitet, wartet auf dich oder ist untätig — und den Verbrauch, wo das CLI ihn preisgibt.
Hält mehrere Terminals gleichzeitig verbunden, stellt sie wieder her und benachrichtigt, wenn ein beobachteter Agent aufhört.
Lädt Bilder und Audio hoch, nimmt Diktate auf und leitet einen entfernten Webdienst in die App oder deinen Browser weiter.
Listet, was pm2 auf dem Rechner ausführt, mit CPU, Speicher, Laufzeit und Neustarts pro App sowie Start/Stopp/Neustart für jede — dazu die Systemlast und den freien Speicherplatz der Maschine selbst.
Spricht Englisch, Deutsch und Russisch, in einem dunklen Design (Steam) und einem hellen (Bento).

Was es nicht tut

SSH ist der Steuerweg für Erkennung, Uploads, Weiterleitung und die moshpit-Einrichtung; nur interaktiver Terminal-Verkehr nutzt moshpit, und das Terminal zeigt mp oder ssh an, sodass ein Rückfall nie ein Rätsel ist. Darüber hinaus:

Kein Konto, kein Werbe-SDK, kein Produkt-Analytics-SDK, kein Relay, das deine Terminals sieht. Siehe die Datenschutzerklärung.
Kein gehosteter Agent und keine gehostete Maschine — Rechner und Agenten-Abonnement bringst du mit.
Noch keine iOS-Version und keine Benachrichtigungen für andere als den verbundenen Rechner.

Was du brauchst

Android 7.0 oder neuer.
Einen Linux-Rechner, den du per SSH erreichst. WSL 2 funktioniert, wenn SSH innerhalb von Linux endet; macOS läuft als eingeschränkte Vorschau, ohne Agentenstatus- und Port-Erkennung.
tmux oder zellij auf diesem Rechner und mindestens ein Agenten-CLI, wenn du mehr als eine Shell willst.

Das Installationsprogramm erledigt all das in einem Befehl, samt Agenten-CLIs und privater Netzwerkroute. Die Anmeldung beim Agenten bleibt immer getrennt und immer deine: führe danach auf dem Rechner claude, codex oder cursor-agent login aus.

Erste Schritte

Installiere die App über Google Play.
Bereite den Rechner vor — Server einrichten ist die ganze Geschichte, und die QR-Kopplung ist ihre Kurzfassung.
Speichere die Verbindung und vergleiche beim ersten Mal den Fingerabdruck des Host-Schlüssels.
Öffne eine Sitzung und halte die Tastenübersicht in der ersten Woche griffbereit.

Von Cookbox erstellte Codex-Sitzungen laufen mit --yolo, was Codex' Rückfragen und Sandboxing abschaltet. Passt diese Vorgabe für einen Rechner nicht, starte Codex dort selbst und lass Cookbox sich an die Sitzung hängen.

Bekannte Grenzen

Der Agentenstatus wird aus Linux' /proc und dem Terminalbild gelesen. Das ist eine gute Heuristik, keine API; Verbrauchsanzeigen verschwinden lieber, als zu raten.
Benachrichtigungen beruhen auf Abfragen: ein Durchgang, der zwischen zwei Abfragen beginnt und endet, kann durchrutschen, und Androids Doze gilt ebenfalls.
Private Schlüssel liegen im privaten Speicher der App, nicht im Android-Keystore.
Uploads bleiben auf dem Rechner unter ~/.cookbox/uploads, bis du sie entfernst.
Eine Nicht-Textdatei, die in einer anderen App geöffnet wird, wird zuerst in Cookbox' eigenen Speicher kopiert, und nur die jüngste Kopie bleibt — die nächste zu öffnen löscht sie.
Weitergeleitete Seiten in der App sind ein iframe ohne eigenen Verlauf — nimm für alles, was navigiert, die Browser-Aktion.