Dein Projekt wird zur Mac-App

Was es ist und warum es zählt

Mit Claude hast du dir ein eigenes Tool gebaut, und jeden Morgen dasselbe Ritual: Terminal öffnen, den Server starten (das Programm, das die App auf deinem Rechner laufen lässt), den richtigen Browser-Tab suchen. Und schließt du das Terminal aus Versehen, ist alles aus.

app-it ist ein kostenloses Open-Source-Projekt (MIT-Lizenz), das du zu Claude Code hinzufügst und das dieses Projekt in eine Mac-App verwandelt, mit eigenem Dock-Icon und eigenem Fenster. Doppelklick: Die App startet den Server selbst und öffnet ein natives Fenster (WebKit, die Engine von Safari). Mit ⌘Q stoppst du auch den Server und gibst den Port frei (die Nummer, etwa 5173, auf der er antwortet).

Es schreibt deine App nicht um: Es fügt ein paar Dateien hinzu und hinterlässt dir einen Bericht, um es rückgängig zu machen. Es ist ein inoffizielles Projekt eines unabhängigen Entwicklers, nicht von Anthropic. Und es ist für dich: nicht, um die App in den App Store zu bringen oder zu verkaufen.

1. Was du vorher brauchst

• Einen Mac. In der Praxis gibt es app-it nur für macOS: Der Windows-Zweig ist noch experimentell, und ich empfehle ihn nicht.
• Die Xcode Command Line Tools, die Entwicklerwerkzeuge von Apple, die zum Bauen des Fensters gebraucht werden. Wenn du sie nicht hast: Gib im Terminal xcode-select --install ein.
• Alles, was dein Projekt schon zum Starten braucht, installiert und funktionsfähig: zum Beispiel Node und seine Abhängigkeiten (npm install schon erledigt). app-it installiert nichts für dich.
• Claude Code, im Projektordner geöffnet.

Der einfachste Test: Wenn du das Projekt heute von Hand im Terminal startest und es läuft, bist du bereit. Startet es von Hand nicht, repariert app-it das nicht: Kümmere dich zuerst darum.

2. Füge es zu Claude Code hinzu

app-it ist ein Plugin, also ein Paket aus Anweisungen und Skripten für Claude Code. Es steht nicht im offiziellen Marketplace von Anthropic, sondern in dem des Projekts auf GitHub: Zuerst fügst du diesen hinzu, dann installierst du das Plugin. In einer Sitzung von Claude Code:

1. Gib /plugin marketplace add Christian-Katzmann/app-it ein. Damit fügst du den Katalog des Projekts hinzu (das Repository ist github.com/Christian-Katzmann/app-it).
2. Gib /plugin install app-it@app-it ein. Es installiert nicht sofort: Es öffnet die Details des Plugins mit dem, was es hinzufügt. Lies sie, dann wähle, wo du es installierst (für dich, in allen Projekten, passt wunderbar).
3. Wenn Claude Code dich darum bittet, gib /reload-plugins ein. Im Terminal heißen dieselben Schritte claude plugin marketplace add und claude plugin install.

Das gilt für jedes Plugin von Dritten: Lies, was du installierst, denn es kann Skripte auf deinem Rechner ausführen. Der Code von app-it ist öffentlich, und das Projekt sagt, dass es nichts hochlädt und keine Daten sammelt.

3. Starte /app-it im Projekt

Öffne Claude Code im Projektordner und gib /app-it ein (der volle Name ist /app-it:app-it). Es schaut sich das Projekt an, entscheidet, wie die App gebaut wird, baut sie, installiert sie und testet sie. So schreibe ich es:

/app-it
Mach aus diesem Projekt eine Mac-App mit eigenem Icon.
Fass die Logik der App nicht an.
Erklär mir am Ende den Bericht in einfachen Worten: welchen Projekttyp du gefunden hast, auf welchem Port es läuft, welches Icon du genommen hast, welche Dateien du hinzugefügt hast und wie man alles wieder entfernt.
Sag mir auch, was ich selbst von Hand prüfen muss.

Die letzte Zeile zählt: Claude prüft selbst, ob der Server antwortet und ob ⌘Q ihn stoppt, aber das Fenster und das Icon im Dock schaust du dir selbst an.

Was es deinem Projekt hinzufügt

• Einen Ordner scripts/ mit den Skripten zum Bauen, Installieren und Beenden der App, dazu die Datei scripts/app-it.config.json mit Name, Port und Startbefehl.
• Ein Icon in assets/, entweder das, das es im Projekt findet, oder ein vorläufiges, das auf deinem Mac erzeugt wird.
• In der package.json die Befehle desktop:build, desktop:install, desktop:quit, desktop:doctor und desktop:verify.
• docs/desktop-launcher.md, die kurze Anleitung, und docs/desktop-launcher.app-it-report.md, den Bericht mit jeder Änderung.

4. Nutze sie jeden Tag

• Erster Start: Wenn macOS sie nicht öffnet, Rechtsklick aufs Icon, Öffnen, und bestätigen. Der erste Start dauert länger, weil der Server bei null anfängt.
• Das Fenster mit ⌘W oder dem roten Punkt zu schließen, stoppt den Server nicht: Er läuft weiter, damit die App beim nächsten Mal sofort wieder aufgeht. Um alles zu stoppen und den Port freizugeben, brauchst du ⌘Q oder Beenden im Menü des Icons im Dock.
• Ist der bevorzugte Port belegt, nimmt die App normalerweise einen freien etwas weiter oben und schreibt ihn in die Datei ~/Library/Application Support/app-it/<app-name>/server.port.
• Die App startet den Server aus dem Projektordner und merkt sich, wo er liegt. Verschiebst oder löschst du ihn, funktioniert die App nicht mehr: Leg ihn zurück, wo er war, oder führe /app-it am neuen Ort noch einmal aus.

Ein Tipp: Zieh den Ordner ~/Applications/App It/ auf die rechte Seite des Docks. Er wird zu einem Stapel, und jede App, die du danach erstellst, erscheint dort von selbst. Für einen Check oder um das Icon zu ändern:

Prüf die App, die du mit app-it erstellt hast.
Führ npm run desktop:doctor aus und sag mir in einfachen Worten: auf welchem Port der Server wirklich läuft, ob das installierte Icon das richtige ist und ob etwas repariert werden muss.
Nimm dann dieses Bild als Icon: [Pfad zum Bild], bau die App neu und installier sie neu.
Fass den Code der App nicht an.

5. Wenn die App fertig ist: app-it-static

app-it lässt den Entwicklungsserver laufen: praktisch, solange du daran arbeitest, aber es belastet den Arbeitsspeicher des Macs. Für ein fertiges Tool gibt es im selben Marketplace einen leichteren Bruder, app-it-static: Er baut die App einmal (den Build, die finale Version der Dateien) und liefert diese aus. Gleiches Fenster, gleicher Stapel im Dock.

Du installierst es mit /plugin install app-it-static@app-it und startest es mit /app-it-static. Die Grenze, die du kennen solltest: Es zeigt eine Momentaufnahme des Builds. Änderst du danach den Code, sieht die App das erst, wenn du npm run desktop:rebuild ausführst.

/app-it-static
Dieses Projekt ist fertig: Ich will eine leichte Mac-App, die den Build ausliefert, ohne Entwicklungsserver.
Bevor du loslegst, sag mir, welchen Build-Befehl du nimmst und in welchem Ordner das Ergebnis landet, und warte auf mein OK.

Extra: eine App, die schon online ist, etwa ein Claude-Artifact

app-it kann auch eine Webadresse in ein Dock-Fenster packen, etwa ein veröffentlichtes Claude-Artifact. Das Fenster lädt den Link, du meldest dich mit deinem Konto an und die Nutzung läuft über deinen Plan. Gib Claude den veröffentlichten Link, nicht den kopierten Code.

6. Wie du es rückgängig machst

Alles, was app-it hinzufügt, lässt sich entfernen, und der Bericht sagt, was. Lass es Claude von dort aus machen und schau dir vorher die Liste an.

Ich will app-it aus diesem Projekt entfernen.
Lies docs/desktop-launcher.app-it-report.md und zeig mir die Liste der Dateien, Ordner und package.json-Zeilen, die app-it hinzugefügt hat, dazu die installierte App in ~/Applications/App It/.
Beende die App vorher mit npm run desktop:quit.
Lösch nichts, bevor ich dir das OK gebe, und fass den Code der App nicht an.

Häufige Fehler

• /app-it auf ein Projekt loslassen, das von Hand nicht startet. Zeigt das Fenster einen Serverfehler, liegt es meist am Projekt: Reparier es im Terminal, dann bau die App neu.
• Mit dem roten Punkt schließen und glauben, alles sei aus. Der Server läuft weiter: Zum Stoppen brauchst du ⌘Q.
• Den Projektordner verschieben oder umbenennen, nachdem die App erstellt wurde. Die App sucht ihn dort, wo er war.
• Die .app-Datei einem Freund schicken, als wäre sie eine echte App. Sie ist nur für deinen Mac signiert, nicht von Apple notarisiert, und ohne den Projektordner und seinen Server läuft sie nicht.

Checkliste

• Das Projekt startet von Hand im Terminal
• Die Xcode Command Line Tools sind installiert (xcode-select --install)
• Ich habe die Details des Plugins app-it vor der Installation gelesen
• Claude hat mir den Bericht von app-it erklärt und was ich von Hand prüfen soll
• Das Fenster zeigt meine App und ihr Icon ist im Dock
• ⌘Q stoppt den Server und gibt den Port frei
• Der Ordner ~/Applications/App It/ ist im Dock

Häufige Fragen