Projekte, Aufgaben, Notizen, Commits und deine KI an einem Ort – auf deinem eigenen Server.
🌐 Webseite & Doku
Funktionen · Screenshots · Installation · Aufgaben ↔ Issues · KI anbinden (MCP) · Discord · Windows-App · Entwicklung
Beim Vibe Coding entstehen schnell viele halbfertige Projekte: hier ein Repo, dort eine Idee,
irgendwo eine Notiz. VibeWorks sammelt alles an einem Ort – Ideen, Status, Aufgaben,
Notizen, Dokumentation und die Commits aus deinen Repositories. Claude Code und andere KIs
arbeiten über MCP direkt mit – mit Regeln, Workflows und Prüfschritten. Es läuft auf deinem eigenen
Proxmox-Server, aktualisiert sich selbst und sieht so aus, wie du willst – auf Deutsch oder
Englisch, einstellbar für jedes Konto.
✨ Funktionen
📸 Screenshots
🚀 Installation auf Proxmox
Auf dem Proxmox-VE-Host ausführen:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/MoinMornhart/vibeworks/main/install/proxmox.sh)"
Das Skript legt einen Debian-LXC-Container an, installiert Node.js, PostgreSQL und VibeWorks
und richtet das automatische Update ein. Details stehen in docs/INSTALLATION.md.
Befehle
Auf dem Proxmox-Host (richtet der Installer ein):
vibeworks status # Version, Releases, Auto-Update, Dienst
vibeworks update # neueste Version installieren
vibeworks domain vibeworks.example.de # Adresse ändern
vibeworks repair # Installation im Container reparieren
vibeworks help # alle Befehle
Auf dem Host gibt es dazu die Abkürzung update (= vibeworks update, auch
update --status usw.). Nachrüsten auf einem bestehenden Host – installiert die Befehle
und holt sofort das neueste Update (eine unvollständige Installation wird dabei repariert):
curl -fsSL https://raw.githubusercontent.com/MoinMornhart/vibeworks/main/install/vibeworks-host.sh -o /usr/local/bin/vibeworks && chmod +x /usr/local/bin/vibeworks && ln -sf /usr/local/bin/vibeworks /usr/local/bin/update && update
Im Container heißt der Befehl update (update --status, update --rollback,
update --domain …, update --help). Außerdem gibt es im Admin-Bereich einen Knopf
„Neuestes Update installieren“.
Der Server prüft zusätzlich alle 15 Minuten selbst auf neue Versionen. Jede Version wird in
einem eigenen Verzeichnis gebaut; erst wenn der Build klappt und die App danach gesund antwortet,
wird umgeschaltet – sonst bleibt bzw. springt alles automatisch auf den letzten funktionierenden
Stand zurück.
🔀 Aufgaben ↔ Issues & Claude Code
Repositories verbinden sich von selbst: Mit einer Git-Verbindung (GitHub, GitLab, Gitea/Forgejo)
legt VibeWorks für jedes eigene Repository ein Projekt an – gleich beim Verbinden und danach alle
30 Minuten für neue. Forks und archivierte bleiben draußen, gelöschte Projekte kommen nicht wieder.
Jeder andere Git-Server geht auch: Verbindung „Beliebiger Git-Server“ mit Zugang als
benutzer:token – Commits und Abhängigkeiten kommen dann direkt per git, Issues und CI gibt es dort
nicht. Fehler (Token abgelaufen, Repository weg …) stehen bei der Verbindung, auf der Projektkarte
und auf dem Dashboard; scheitert ein Abgleich dreimal in Folge, kommt eine Benachrichtigung.
Trägst du am Projekt ein Repository ein, zeigt VibeWorks dessen Commits unter den Notizen.
Mit einer Git-Verbindung (Mein Konto → Git-Verbindungen – GitHub, GitLab oder Gitea/Forgejo,
auch selbst gehostet) wird zusätzlich jede Aufgabe automatisch zum Issue. Die Verbindung gilt
für alle deine Projekte auf diesem Server; der Server gleicht alle 5 Minuten selbst ab – mit
einem Webhook (Projektseite → Git & Updates → Zugang) sogar sofort. Der Status wandert
in beide Richtungen mit:
| Spalte in VibeWorks | Issue im Repository |
|---|
| Offen | offen |
| In Arbeit | offen, Label in Arbeit |
| Blockiert | offen, Label blockiert |
| Erledigt | geschlossen |
Damit lassen sich Aufgaben bequem von einer KI abarbeiten – zum Beispiel mit
Claude Code: „Arbeite die offenen Issues ab.“ Claude holt
sich die Issues mit gh issue list, setzt in Arbeit, committet mit Fixes #12 – das Issue
schließt sich, und beim nächsten Abgleich springt die Aufgabe in VibeWorks auf Erledigt.
flowchart LR
A["Aufgabe in VibeWorks"] -- automatisch --> B["Issue auf GitHub"]
B -- "gh issue list" --> C["Umsetzung mit Claude Code"]
C -- "Commit: Fixes #12" --> D["Issue geschlossen"]
D -- Abgleich --> E["Aufgabe erledigt"]
Die App zeigt beim Verbinden eine kurze Anleitung mit Link zur passenden Token-Seite:
| Anbieter | Token |
|---|
| GitHub | Klassisches Token mit den Rechten repo, admin:repo_hook (Webhooks) und workflow (Repo-Check); der Link ist vorausgefüllt |
| GitLab | Personal-Access-Token mit dem Scope api |
| Gitea / Forgejo | Token mit repository: Lesen und issue: Lesen und Schreiben |
Die Verbindung lässt sich schon bei der Registrierung eintragen oder später unter „Mein Konto“.
Ein eigenes Token pro Projekt geht weiterhin (Projektseite → Git & Updates → Zugang).
Für öffentliche Repositories ohne Issue-Spiegelung reicht die Adresse – dann braucht es gar kein
Token. Tokens werden beim Speichern geprüft, mit AES-256-GCM verschlüsselt gespeichert und nie
wieder vollständig angezeigt.
🤖 KI anbinden (MCP)
VibeWorks ist auch ein MCP-Server. Drei Wege zum Anschluss:
Danach arbeitet die KI direkt mit deinen Projekten – ganz ohne Umweg über GitHub:
| Werkzeug | Was es tut |
|---|
list_projects, get_project | Projekte mit Status, offenen Aufgaben, Notizen und Repository |
list_tasks, get_task | Aufgaben über alle Projekte – z. B. alles, was diese Woche fällig ist |
create_task, update_task | Aufgaben anlegen und nach In Arbeit oder Erledigt schieben – gespiegelte Issues laufen mit |
list_task_comments, add_task_comment | Das Gespräch unter einem Issue lesen und antworten |
create_task_in_projects | Dieselbe Aufgabe in mehreren Projekten – ohne Angabe in allen mit Git |
get_claude_md, get_agent_file, list_prompts, get_prompt | Anleitung für die KI (CLAUDE.md, AGENTS.md, Cursor …) und deine Prompt-Bibliothek |
update_project, review_projects | Status, Priorität, Fortschritt, Kurzbeschreibung – und ein Überblick, wo etwas fehlt |
get_project_structure, update_project_structure | Tabelle, wie das Projekt aufgebaut ist |
list_workflows, start_workflow, complete_workflow_step, save_workflow | KI-Workflows Schritt für Schritt mit Prüfung abarbeiten |
get_ci, save_ci, run_ci | CI-Pipeline lesen, ändern und starten |
list_code_files, search_code, get_code_graph, add_code_memo | Code durchsuchen, Zusammenhänge sehen, Notizen am Code |
create_note, get_note | Notizen am Projekt, z. B. ein Arbeitsprotokoll |
search | Volltextsuche über Notizen, Aufgaben und Docs |
list_docs, get_doc, create_doc, update_doc | Docs lesen und schreiben |
get_repo_status, list_problems |
Außerdem erscheint deine Prompt-Bibliothek in Claude Code als Befehle (/mcp__vibeworks__…, auf Wunsch mit
einem Projekt ausgefüllt), und die CLAUDE.md jedes Projekts, „Was klemmt“ und „Heute“ lassen sich als
Ressourcen anhängen (@vibeworks:…).
Außerdem stehen die mitgelieferten Workflows (Feature, Fehler, Release …) als Befehle bereit.
Probier zum Beispiel: „Welche Aufgaben sind in VibeWorks offen?“ oder „Arbeite die offenen Aufgaben
von Projekt X ab und halte fest, was du gemacht hast, als Notiz.“ Claude handelt mit deinen Rechten,
jede Änderung steht im Verlauf des Projekts. Von jedem Schlüssel wird nur ein Hash gespeichert; du
kannst ihn jederzeit widerrufen. Andere MCP-Clients verbinden sich per Streamable HTTP mit
/api/mcp und demselben Header.
💬 Discord
Unter Mein Konto → Discord den VibeWorks-Bot per Klick in deinen Server einladen (der Admin
richtet Discord dafür einmal unter Administration ein). Der Bot leitet deine Benachrichtigungen
in einen Kanal weiter, schickt auf Wunsch jeden Morgen oder montags einen Kurzbericht und beantwortet
/vibeworks status, aufgaben, probleme und hier.
🪟 Windows-App
⬇️ VibeWorks-Setup.exe herunterladen –
ausführen, Adresse deines Servers eintragen, anmelden. Die App aktualisiert sich danach selbst.
- Eigenes Fenster statt Browser-Tab, mit Startmenü-Eintrag
- Tray neben der Uhr – Schließen lässt die App im Hintergrund weiterlaufen (abschaltbar)
- Schnellerfassung mit Strg+Alt+V – aus jedem Programm heraus eine Idee oder Aufgabe festhalten
- Windows-Benachrichtigungen für fällige Aufgaben, rote CI, Zugriffsanfragen und alles andere aus Mein Konto → Benachrichtigungen
Der Installer ist (noch) nicht signiert: Beim ersten Start meldet Windows „Der Computer wurde durch
Windows geschützt“ – dann auf Weitere Informationen → Trotzdem ausführen klicken. Der Code liegt
in desktop/; GitHub Actions baut bei jeder neuen App-Version den Installer.
🛠️ Entwicklung
npm install
npm run setup # .env mit zufälligem APP_SECRET anlegen
npm run db:migrate # Schema in die PostgreSQL aus DATABASE_URL einspielen
npm run dev # → http://localhost:3000
| Skript | Zweck |
|---|
npm run dev | Entwicklungsserver |
npm run build / npm start | Produktionsbuild und -start |
npm run typecheck | TypeScript prüfen |
npm test | Unit-Tests (Vitest) |
npm run check:code | Toter Code und Zyklen (fallow) |
npm run version:bump | Version um eine Stufe erhöhen |
Stack: Next.js 16 (App Router) · React 19 · TypeScript · Tailwind CSS 4 · Prisma 7 ·
PostgreSQL · SimpleWebAuthn · dnd-kit · Vitest · fallow
Jeder Push läuft durch die GitHub-Actions-CI (Typen, Tests, fallow, Build).
Versionsschema
Versionen zählen wie ein Zählwerk mit Übertrag bei 9:
0.0.1 → 0.0.2 → … → 0.0.9 → 0.1.0 → … → 0.9.9 → 1.0.0.
Die angezeigte Version kommt aus package.json; die Zahl der Commits ist nur die Update-Nr.
Jede ausgelieferte Änderung bekommt einen Eintrag im Änderungsverlauf (src/lib/changelog.ts), der in der App angezeigt wird.
🗺️ Fahrplan
✅ = fertig · ⏳ = kommt noch
Etappe 1 – Grundlagen ✅
- ✅ Anmeldung mit Passwort, Passkeys und Zwei-Faktor, Mehrbenutzerbetrieb
- ✅ Projekte, Notizen, Aufgaben und Mini-Docs
- ✅ Persönliches Design für jedes Konto
- ✅ Oberfläche auf Deutsch und Englisch
- ✅ Proxmox-Installer,
update-Befehl und Auto-Update
Etappe 2 – Git-Anbindung
- ✅ Commits auf der Projektseite
- ✅ Aufgaben ↔ Issues (GitHub, GitLab, Gitea/Forgejo)
- ✅ Git-Verbindungen fürs ganze Konto, Abgleich im Hintergrund
- ✅ Projekte teilen
- ✅ CI-Status (GitHub Actions, GitLab-Pipelines, Gitea)
- ✅ Webhooks – Änderungen kommen sofort an
Etappe 3 – Überblick & Komfort
- ✅ Wochenrückblick und Zeitleiste
- ✅ Projektvorlagen (eingebaute und eigene)
- ✅ Import/Export als JSON
- ✅ Benachrichtigungen (ntfy, Webhook, E-Mail)
Etappe 4 – KI, Überwachung & Spaß
- ✅ VibeWorks als MCP-Server für Claude Code – Aufgaben, Notizen und Docs direkt aus Claude heraus
- ✅ Windows-App mit Tray, Schnellerfassung per Tastenkürzel, Windows-Benachrichtigungen und Auto-Update
- ✅ Automatischer Fortschritt per Analyse aus Aufgaben, Commits, CI und Planung – mit „Wie berechnet?“
- ✅ Eine Aufgabe für mehrere Projekte auf einmal, z. B. für alle mit Git
- ✅ Live-Überwachung: Erreichbarkeit, Antwortzeit, SSL-Ablauf und Uptime-Balken
- ✅ Projekt-Friedhof: Anstupsen nach 30 Tagen Ruhe, Grabstein mit Lebensdauer – und Wiederbelebung
- ✅ Aktivitäts-Heatmap über alle Projekte, Streaks und kleine Erfolge
- ✅ Kosten je Projekt (Hosting, Domain, KI-APIs) mit Warnung vor Domain-Ablauf
- ✅ Prompt-Bibliothek und CLAUDE.md-Generator aus Beschreibung, Notizen und Aufgaben
- ✅ Ideen-Eingang per „Teilen“ vom Handy (PWA), Einwurf-Adresse (auch für Mail-Weiterleitungen) oder ntfy
- ✅ Zeiterfassung und Fokus-Timer je Aufgabe, ausgewertet im Wochenrückblick
- ✅ Heute-Ansicht: Aufgaben aus allen Projekten für den Tag vormerken und abhaken
- ✅ Abhängigkeiten-Check: veraltete Pakete und Sicherheitswarnungen aus dem Repository
- ✅ Was der Abhängigkeiten-Check markiert, steht sofort als Aufgabe im Board – und erledigt sich selbst
- ✅ Repo-Check ohne KI (GitHub Actions): Geheimnisse, Sicherheitslücken, Fehlermuster und TODOs
- ✅ Fehler-Eingang: Apps melden Laufzeitfehler per Schnipsel (Browser, Node.js, curl), zusammengefasst, mit Benachrichtigung
- ✅ Einladungslinks für neue Konten: einmal nutzbar, mit Ablaufdatum, auch bei geschlossener Registrierung
- ✅ Community für die Konten der Instanz: Projekte vorstellen, Fragen, Ideen und Fehlerberichte, Chat (Lobby und je Projekt), Moderation, Melden und Sperren
- ✅ Vorstellungs-Folien je Projekt: automatisch aus Beschreibung, Stand, Commits und nächsten Schritten, mit Vollbild und Tastatur
- ✅ Teams: Projekte an ganze Teams freigeben, Beitritt nur per Einladung
- ✅ Rollen mit einzelnen Rechten für Mitglieder und Teams – Standardrollen, Admin-Vorlagen und eigene Rollen
- ✅ Öffentliches Portfolio mit ausgewählten Projekten
Etappe 5 – KI-Arbeit & Automatisierung
- ✅ Einzeiler-Installation, Geräte-Anmeldung und Projekt-Schlüssel für KI-Programme
- ✅ KI-Workflows mit Prüfschritten und Projektaufbau-Tabelle – auch fürs ganze Team
- ✅ Aufbau-Wächter: meldet, wenn die Aufbau-Tabelle nicht mehr zum Repository passt
- ✅ Wochenbericht montags über ntfy, Webhook, E-Mail oder Discord
- ✅ Lighthouse-Check der Live-Seite (Leistung, Barrierefreiheit, SEO, kaputte Links) als Schalter
- ✅ Anleitungen für Claude, Codex, Gemini, Copilot, Cursor, Windsurf und Cline
- ✅ Issues aus GitHub werden Aufgaben, Bot per Klick, Befehle in Issue-Kommentaren
- ✅ CI-Designer mit Live-Anzeige
- ✅ Abhängigkeiten für npm, PyPI, Cargo, Go, Composer und Maven, Zweig wählbar
- ✅ Code-Netz, Code-Suche und Merge-Konflikte im Browser
- ✅ Discord-Bot mit Befehlen, Benachrichtigungen und Berichten
- ✅ Erste Schritte auf dem Dashboard
Webseite
- ✅ Landingpage auf GitHub Pages mit Installationsbefehl zum Kopieren – moinmornhart.github.io/vibeworks
- ✅ Demo-Modus mit schreibgeschütztem Demo-Konto, Beispieldaten und nächtlichem Reset (Demo-Instanz)
- ⏳ Öffentliche Live-Demo
- ✅ Doku-Seiten auf Deutsch und Englisch
- ✅ Kurzes Vorführ-GIF: Aufgabe → Issue → Claude → erledigt
📄 Lizenz
MIT – siehe LICENSE.
