@mathiasdangl/vibe-studio
v0.1.6
Published
VibeStudio — dein lokaler Vibing-Agent. Beschreibe deine Idee, VibeStudio übernimmt Architektur, Versionskontrolle und Hosting.
Maintainers
Readme
VibeStudio
Dein lokaler Vibing-Agent. Beschreibe deine Idee — VibeStudio übernimmt Architektur, Code, Versionskontrolle (GitHub) und Hosting (Cloudflare). Komplett mit deinen eigenen Zugängen: dein LLM-Key (oder lokal via Ollama), dein GitHub, dein Cloudflare. VibeStudio hat mit Abrechnung nichts zu tun — pay as you can.
Was es macht
- Vibing statt Coding: Du chattest, der Agent plant, baut und strukturiert die App (Vite + React + Hono auf Cloudflare Workers).
- Automatische Versionskontrolle: Jede Änderung = ein gesicherter „Stand". Timeline in der UI, Ein-Klick-Rückkehr zu jedem Stand, automatische Sicherung in deinem GitHub-Repo.
- Automatisches Veröffentlichen: Nach jedem grünen Build deployt VibeStudio auf deinen Cloudflare-Account (
*.workers.dev). Registriert auch die workers.dev-Subdomain für frische Accounts. - Build-Gate mit Auto-Reparatur: Es wird nie ein kaputter Stand gespeichert oder veröffentlicht. Schlägt der Build fehl, repariert der Agent (max. 5 Versuche) oder kehrt zum letzten guten Stand zurück.
- Provider-agnostisch: Jeder OpenAI-v1-kompatible Endpoint funktioniert — Ollama (lokal, kostenlos), Anthropic, OpenAI, OpenRouter, eigene Endpoints.
Schnellstart
Du kannst VibeStudio direkt ohne Installation starten:
npx --package @mathiasdangl/vibe-studio vibe-studioTipp: Der Terminal-Link enthält deinen Sitzungsschlüssel — kopiere den Link und öffne ihn im Browser.
Danach führt dich das Onboarding durch drei Schritte:
- KI-Modell — Ollama lokal oder API-Key (Anthropic/OpenAI/OpenRouter/eigener Endpoint). Pflicht. Es gibt einen echten Probelauf inkl. Tool-Calling-Test.
- GitHub — Personal Access Token (classic,
repo-Scope). Optional, sichert dein Projekt als Git-Repo in die Cloud. - Cloudflare — API-Token (Vorlage „Edit Cloudflare Workers" plus zusätzliche Berechtigung
Account > D1 > Edit) + Account-ID. Optional, ermöglicht das automatische Hosting deiner App & Datenbank!
Sicherheit
- Server bindet ausschließlich an
127.0.0.1, Host-Header-Validierung (DNS-Rebinding-Schutz), Session-Token pro Start für alle API-Calls. - Alle Schlüssel liegen nur lokal in
~/.vibe-studio/config.json(chmod 600) und werden nie an die Browser-UI gesendet. - Git-Push authentifiziert über
GIT_ASKPASS— der Token landet nie in.git/configoder der Prozessliste. - Agent-Dateizugriffe sind auf den Projektordner beschränkt (Pfad-Validierung,
.git/node_modulestabu); Kommandos sind aufnpmbegrenzt und laufen ohne Shell.
Architektur
bin/vibe-studio.js Launcher (npx vibe-studio)
server/ Hono-Server (localhost), SSE-Events
agent/ Vibing-Agent: Loop, Tools, System-Prompt
gitops.ts Commits, Timeline, konfliktfreies Restore
github.ts Token-Check, Repo-Erstellung
cloudflare.ts Token-Check, Subdomain-Registrierung, wrangler deploy
preview.ts vite-dev-Prozess pro Projekt (Live-Vorschau)
template/ Eingebettetes Projekt-Template (Vite+React+Hono+Wrangler, Versionen gepinnt)
ui/ Browser-UI (React, Apple-Design)Projekte liegen unter ~/VibeStudio/<name> — echte Git-Repos, die dir gehören. Du kannst sie jederzeit ohne VibeStudio weiterentwickeln (npm run dev / npm run deploy im Projektordner).
Voraussetzungen
- Node.js ≥ 20, git
- Für die Live-Veröffentlichung: kostenloses Cloudflare-Konto
- Für die Sicherung: kostenloses GitHub-Konto
