> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Einrichtung durch einen Agenten

Fügen Sie einen fertigen Prompt in einen Coding-Agenten ein, lassen Sie ihn die Desktop-Einrichtung auf Ihrem Computer ausführen und prüfen Sie den Bericht, den er zu jedem Schritt schreibt.

## Sie können den langweiligen Teil delegieren

Dieses Repository wurde so geschrieben, dass ein Coding-Agent es lesen kann. Es enthält eine Kartendatei (`llms.txt`), eine Regeldatei (`AGENTS.md`), dateibezogene Gedächtnisnotizen (`.ai/`) und Aufgaben-Skills (`.agents/skills/`). Der eigenständige Desktop-Checkout enthält nicht den Ordner `prompts/`, daher ist der fertige Prompt in diesem Handbuch abgedruckt — kopieren Sie ihn von unten, statt eine Datei zu öffnen.

Das Delegieren des Tippens bedeutet nicht, die Kontrollen zu überspringen. Der Agent arbeitet in Ihrer Kopie des Repositorys und muss mit Belegen berichten, was er getan hat. Die folgenden Abschnitte zeigen, wie ein guter Bericht aussieht, damit Sie die Kontrolle über das Ergebnis behalten.

Dieser Pfad richtet die Tauri-Shell und ihre Verbindung zum Web-Backend ein — dem Server, der Konten und Daten verarbeitet. Das Desktop-Fenster zeigt nur dieses Backend an; wenn Ihr Checkout auch apps/web enthält, kann der Agent es lokal ausführen, und ein reines Desktop-Checkout benötigt die Ihnen mitgeteilte, erreichbare Backend-Adresse.

[Führen Sie die Desktop-App stattdessen von Hand aus](https://supastack.dev/de/docs/desktop/ship-in-5-minutes.md)


## Was Sie zuerst brauchen

Schließen Sie zuerst die Vorbereitungsanleitung ab: Node.js, Git und ein Editor installiert, die GitHub-Einladung angenommen und der supastack-Ordner auf Ihren Computer heruntergeladen. Der Agent arbeitet in diesem Ordner, daher gilt alles aus [Bevor Sie beginnen](https://supastack.dev/de/docs/desktop/before-you-start.md) weiterhin.

Außerdem brauchen Sie ein Werkzeug, das als Coding-Agent arbeiten kann — ein Editor mit eingebautem KI-Coding-Agenten (eine KI-IDE) oder ein Agent, der in Ihrem Terminal läuft (eine Agenten-CLI). Jedes aktuelle agentenfähige Werkzeug funktioniert; der Prompt legt bereits fest, was er lesen und ausführen muss, sodass Sie keine Anweisungen selbst schreiben müssen.

Entscheiden Sie abschließend zwei Dinge, nach denen der Prompt fragt: die Backend-Adresse, die das Fenster laden soll — http://localhost:3000 für ein lokales Backend oder Ihre bereitgestellte HTTPS-Adresse — und ob Rust und die nativen Build-Werkzeuge auf diesem Computer bereits installiert sind.


## Prompt kopieren, zwei Lücken ausfüllen, einfügen

Der Prompt ist der Codeblock unten — markieren und kopieren Sie den gesamten Block.

Zwei Platzhalter erfordern Ihre Auswahl. Ersetzen Sie `<APP_URL>` durch die Backend-Adresse, die das Fenster laden soll — http://localhost:3000 für ein lokales Backend oder Ihre bereitgestellte HTTPS-Adresse. Ersetzen Sie `<TOOLCHAIN: present | install>` durch present, wenn rustc und cargo bereits Versionen ausgeben, oder install, wenn der Agent zuerst Rust und die OS-Build-Werkzeuge einrichten soll. Die nummerierten Schritte bleiben exakt wie geschrieben.

```
Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.
```


## Was der Agent mit dem Prompt macht

Der Prompt weist den Agenten auf die Karte, die Regeln und die Sicherheitscheckliste hin und weist ihn an, die Einrichtung der Reihe nach zu durchlaufen und jede Phase zu beweisen. Einfach ausgedrückt wird der Agent:

- Liest die Repository-Karte (`llms.txt`), die Projektregeln (`AGENTS.md`) und die Regeln zum Umgang mit Zugangsdaten (`docs/agent-security.md`), bevor irgendetwas angefasst wird.
- Prüft die Rust-Toolchain und die Tauri-Voraussetzungen dieses Betriebssystems und meldet, was es installiert, statt mitten in einem Compile zu scheitern.
- Überprüft, ob das Backend unter Ihrer Adresse antwortet — und startet `apps/web` nur dann selbst, wenn dieser Ordner in diesem Checkout existiert —, statt einen nicht vorhandenen Server anzunehmen.
- Installiert Abhängigkeiten, kompiliert die Shell und öffnet das Fenster, dann meldet es Fenster-, Tray- und Aufruf-Tastenkürzel-Verhalten mit der tatsächlichen Ausgabe.
- Stoppt und meldet, nachdem derselbe Schritt zweimal fehlgeschlagen ist — er umgeht einen Fehler nicht und löscht nichts ohne Nachfrage.


## Was Sie im Bericht des Agenten prüfen

Ein guter Bericht zeigt Beweise, keine Behauptungen. Achten Sie auf die antwortende Backend-URL, die abgeschlossene Abhängigkeitsinstallation, einen fertigen Rust-Compile und ein geöffnetes Fenster hinter jedem PASS — nicht auf einen Satz wie „alles funktioniert“.

Der Prompt weist den Agenten an, nach dem zweiten Fehlschlag desselben Schritts zu stoppen und zu melden — statt den Fehler zu umgehen — und vor allem Zerstörerischen nachzufragen. Wenn Ihr Agent nach wiederholten Fehlern weiter improvisiert, stoppen Sie ihn und bringen Sie den ersten Fehler zum [Handbuch zur Fehlerbehebung](https://supastack.dev/de/docs/desktop/troubleshooting.md).

Zwei Dinge dürfen nie vorkommen: ein Sicherheitsfeature, das abgeschaltet wurde, um einen Fehler zum Schweigen zu bringen, und ein geheimer Wert wie ein Passwort oder Schlüssel, der in den Chat oder den Bericht geschrieben wurde. Wenn Sie eines davon sehen, werten Sie den Lauf als fehlgeschlagen.

Halten Sie Shell und echte Anmeldung gedanklich getrennt. Das Fenster, das die Startseite Ihres Backends zeigt, beweist die Shell — echte Konten benötigen weiterhin die Datenbank des Backends. „Das Fenster hat sich geöffnet“ ist noch nicht „Konten funktionieren“.


## Wenn Sie es lieber von Hand machen

Jeder Schritt, den der Agent ausführt, ist in den manuellen Handbüchern unten ausgeschrieben — dieselben Befehle, dieselben Prüfungen, in Ihrem Tempo.

[Führen Sie die Desktop-App in 5 Minuten aus](https://supastack.dev/de/docs/desktop/ship-in-5-minutes.md)

[Lesen Sie die vollständige Shell-Einrichtung](https://supastack.dev/de/docs/desktop/run.md)

[Beheben Sie einen Einrichtungsfehler](https://supastack.dev/de/docs/desktop/troubleshooting.md)


## Weiter

[Desktop in 5 Minuten starten](https://supastack.dev/de/docs/desktop/ship-in-5-minutes.md)
