Agents auf dem Server,
beantwortet von deinem Mac.

Klick in Gnistas Einstellungen ▸ Entfernt auf „Verbinden“ und wähl einen Host aus deiner ssh-Config. Gnista kopiert seinen Helper dorthin, verbindet jeden Agent, den es findet, und hält über dein eigenes ssh eine Verbindung offen. Ihre Sitzungen erscheinen in der Notch mit dem Namen des Rechners.

• Gnista auf deinem Mac, macOS 15 oder neuer.
• Ein Linux-Server, x86_64 oder arm64, oder ein Mac mit eingeschalteter Entfernter Anmeldung.
• Deine Agents dort installiert, für den Nutzer, mit dem du dich anmeldest: Claude Code, Codex, Gemini CLI, OpenCode, Copilot CLI oder jeder andere Agent, den Gnista auf deinem Mac verbindet.
• Der Rechner in deiner ~/.ssh/config. Am einfachsten ist ein Schlüssel, der nichts von dir braucht; verlangt die Anmeldung ein Passwort, einen Code oder eine Schlüsselfreigabe, fragt Gnista dich einmal, im Terminal.

Ein Eintrag wie dieser reicht. Gnista übernimmt alles, was in deiner Config steht, also funktionieren Ports, Nutzer, Schlüssel, ProxyJump und die Hosts, die Coder, Codespaces oder DevPod dort eintragen, genau wie im Terminal.

Host devbox
  HostName devbox.example.com
  User dev
  IdentityFile ~/.ssh/id_ed25519

ssh devbox uname -sm

Die Ausgabe sollte Linux x86_64, Linux aarch64 oder Darwin arm64 sein. Fragt ssh, ob du dem Host-Schlüssel vertraust, beantworte die Frage dort einmal.

1. Öffne Gnistas Einstellungen ▸ Entfernt. Klick auf „Verbinden“ und wähl den Host, hier devbox. Einer, der nicht in deiner Config steht: „Anderer Host …“, dann eintippen.
2. Gnista prüft das System mit uname, kopiert seinen Helper für dieses System nach ~/.gnista dort und prüft, ob er unverändert angekommen ist. Dann trägt es seine Hooks bei jedem Agent ein, den es findet.
3. Die Zeile des Rechners sagt, wie viele verbunden sind, etwa „Verbunden, 2 Agents“. Fahr mit der Maus darüber, um ihre Namen zu sehen.
4. Steht in der Zeile „Braucht deine Anmeldung.“, klick auf „Anmelden“. Das Terminal öffnet sich, du meldest dich einmal an, und Gnistas Verbindung läuft über diese Anmeldung.
5. Starte eine Sitzung auf dem Server. Ihre Zeile erscheint in der Notch, mit dem Namen des Servers neben dem Projekt.

• Eine Zeile pro Sitzung, mit dem Namen des Rechners dort, wo eine lokale Zeile ihre App zeigt. Fahr mit der Maus darüber: „Auf devbox, über SSH“.
• Ihre Anfragen in der Notch. Fragt der Agent etwas, öffnet sich die Notch mit der Anfrage, wie bei einer lokalen Sitzung. Ist Einstellungen ▸ Allgemein ▸ Rückfragen in Gnista beantworten an, gibst du sie dort frei; Gnista hält diese Einstellung auf dem Server synchron.
• Details. Titel, letzte Nachricht sowie Tokens und Kosten, auf dem Server gelesen, für die Agents, die sie festhalten.
• Der richtige Tab. Ein Klick holt den Terminal-Tab auf deinem Mac hervor, über dessen ssh, mosh oder Eternal Terminal der Agent kam, samt seinem tmux-Pane. Bei einem Remote-Fenster von VS Code, Cursor, Windsurf oder Zed dieses Fenster; bei einer Sitzung, die Claude Desktop per SSH gestartet hat, ihren Chat.
• Eine Anmeldung. Einrichtung, Verbindung und Klicks teilen sich eine ssh-Verbindung, also kommt ein Duo-Push oder eine Schlüsselfreigabe einmal, nicht jedes Mal.
• Eine Verbindung, die wiederkommt. Nach einem Abbruch, dem Ruhezustand oder einem Netzwechsel verbindet Gnista sich von selbst neu. Bis dahin bleiben die Zeilen, und beim Rechner steht „Gerade nicht erreichbar.“

Im ⋯-Menü jedes Rechners gibt es die Einstellung „Verbindung“. „Automatisch“ passt für die meisten Server. „Ohne Weiterleitung“ schickt die Nachrichten der Hooks über einen gewöhnlichen ssh-Befehl statt über eine Weiterleitung. „Über mein eigenes ssh“ lässt Gnista ohne eigene Verbindung: „Einrichten“ installiert den Helper einmal und gibt dir eine RemoteForward-Zeile für deine ssh-Config, sodass deine eigenen ssh-Sitzungen die Events der Agents mitnehmen. Für dein IT-Team: Sicherheit und Datenschutz.

Verbinde denselben Server von jedem deiner Macs aus. Jeder bekommt dort einen eigenen Socket, alle zeigen seine Sitzungen, und die erste Antwort auf eine Anfrage entscheidet. „Trennen“ auf einem Mac lässt Gnista für die anderen auf dem Server.

Jedes Mal, wenn die Verbindung startet, bringt Gnista das auf den neuesten Stand: einen neuen Helper nach einem Update von Gnista und Hooks für einen Agent, der seitdem dazugekommen ist. Die Einstellungen deiner Agents werden gesichert, bevor Gnista seine Hooks einträgt, und deine eigenen Hooks bleiben.

Für jeden Rechner öffnet Gnista einen Socket auf deinem Mac und startet dein ssh mit einer Reverse-Weiterleitung dorthin. Die Hooks dort sprechen also über diese Verbindung mit Gnista auf deinem Mac. Kurz gesagt:

ssh -N -o ControlMaster=yes -R /home/dev/.gnista/sockets/<this Mac>.sock:<a socket on your Mac> -- devbox

Leitet der Server keine Sockets weiter, leitet Gnista stattdessen einen Port auf seinem Loopback weiter, und jede Verbindung muss mit einem Passwort beginnen, das nur dein Konto dort lesen kann. Leitet er gar nichts weiter, trägt der Helper die Nachrichten der Hooks über einen gewöhnlichen ssh-Befehl.

Welcher Server in einer Zeile steht, ergibt sich aus der Verbindung, über die ein Event kam, nicht aus dem, was der Server behauptet. Ein Server kann sich also nicht als ein anderer ausgeben. Ist die Verbindung unterbrochen, finden die Hooks kein Gnista, kehren sofort zurück, und der Agent fragt wie gewohnt in seinem Terminal.

Der Helper für Linux kommt aus Gnistas öffentlichen Downloads auf GitHub, einmal pro Version von Gnista und Prozessor, und Gnista nutzt ihn nur, wenn er mit Gnistas Schlüssel für diese Version signiert ist. Ein Mac bekommt den Helper von deinem Gnista, signiert und notarisiert.

• „ssh meldet: …“ Die letzten Worte von ssh selbst. Führ die Prüfung oben mit demselben Host aus und klick dann erneut auf „Verbinden“.
• „Braucht deine Anmeldung.“ Klick auf „Anmelden“ und melde dich im Terminal an. Mit 1Password wartet dessen Abfrage vielleicht hinter anderen Fenstern; fahr mit der Maus über die Zeile, um zu sehen, was ssh gesagt hat.
• „Gerade nicht erreichbar.“ Fahr mit der Maus über die Zeile, um die Worte von ssh zu sehen. Gnista versucht es weiter und wartet jedes Mal länger.
• „Gnista verbindet Linux-Rechner und Macs; dieser ist „…“.“ Auf dem Host läuft ein anderes System, das Gnista nicht verbinden kann.
• „Gnista konnte seinen Helfer für Linux nicht laden. Prüfe, ob der Mac online ist, und versuch es noch einmal.“ Dein Mac muss github.com erreichen, wenn ein Server zum ersten Mal den Helper für diese Version braucht.
• „Der Helfer kam verändert an, daher hat Gnista ihn nicht verwendet.“ Klick erneut auf „Verbinden“.
• „Verbunden, aber keiner seiner Agenten ist einer, den Gnista verbindet.“ Installier einen Agent auf dem Server, für denselben Nutzer. Gnista verbindet ihn, sobald die Verbindung das nächste Mal startet, oder sofort, wenn du auf „Trennen“ und dann auf „Verbinden“ klickst.
• „Es ist dasselbe Konto wie …, das schon verbunden ist.“ Zwei Namen in deiner ssh-Config führen zum selben Konto. Behalte einen.
• Eine Sitzung taucht nicht auf. Prüf, ob in der Zeile des Rechners „Verbunden“ steht, und starte dann eine neue Sitzung; eine, die schon lief, hat Gnistas Hooks womöglich nicht.
• „Von deiner Organisation deaktiviert.“ Dein Mac wird verwaltet, und RemoteMachinesAllowed ist aus. Frag dein IT-Team.

• Terminal-Benachrichtigungen: Claude Codes eigene Benachrichtigungen sind Escape-Codes im Terminal, sie kommen also per ssh bei iTerm2 und anderen Terminals an, die sie anzeigen. Sie sagen dir, dass etwas passiert ist, nicht auf welchem Server oder in welcher Sitzung, und antworten musst du im Tab.
• Eine tmux-Glocke, mit monitor-bell und einem Terminal, das Glocken in Mitteilungen verwandelt. Gratis, mit denselben Grenzen.
• Ein Hook, der an einen Push-Dienst fürs Handy schickt, etwa ntfy. Er erreicht dich überall, aber du schreibst ihn und hältst ihn am Laufen, und zum Antworten musst du trotzdem ins Terminal.

• Wer auf dem Server root ist, kann deine Freigaben beantworten, denn er kommt an den Socket. Verbinde nur Server, denen du vertraust.
• Antworten aus der Notch und Abolimits gibt es nur für Sitzungen auf deinem Mac; die Zeilen eines Servers haben sie nicht.
• „Trennen“ entfernt Gnistas Hooks und ~/.gnista vom Server, außer ein anderer Mac nutzt sie noch. Ist der Server in dem Moment nicht erreichbar, bleiben die Hooks; ohne Gnista tun sie nichts.
• Agents in Containern oder Kubernetes-Pods: Agents in Containern.
• Organisationen können entfernte Rechner auf ihren Macs abschalten: verwaltete Einstellungen. Was Gnista wohin sendet: Datenschutz.
• Sieben Tage gratis, dann einmalig 19 €. Mehr zu Claude Code, Codex, Gemini CLI und OpenCode.