HaikoDev ist kein Onlinedienst, den man abonniert: Es ist ein Programm, das Sie auf Ihrer Maschine installieren. Dort liegen Ihre Projekte, dort laufen die Agenten, und nach draussen geht nur das, was die von Ihnen gewählten Engines erhalten. Diese Anleitung beginnt bei null und endet mit einem Board, das dauerhaft läuft.

Rechnen Sie beim ersten Mal mit einem Abend. Kein Schritt verlangt, dass Sie Entwickler sind, aber alle laufen im Terminal: Wenn Ihnen die Befehle wenig sagen, tippen Sie sie einfach genau so ab, der Reihe nach.

Was Sie vorher brauchen

  • Eine Linux-Maschine, die eingeschaltet bleibt: Ein kleiner gemieteter Server genügt völlig.
  • Node.js Version 22 oder neuer — die Laufzeit, die das Programm ausführt.
  • git, das Werkzeug, das ein Code-Repository holen kann.
  • Ein GitHub-Konto und Zugang zum HaikoDev-Repository (siehe Schritt 1).
  • Mindestens eine KI-Engine, die bereits installiert und auf der Kommandozeile angemeldet ist: Claude Code, Codex oder Cursor. HaikoDev steuert sie, es ersetzt sie nicht.
Prüfen, was schon da ist
node --version   # muss v22 oder neuer anzeigen
git --version

Schritt für Schritt

  1. Zugang zum Repository bekommen

    Das Repository von HaikoDev liegt unter https://github.com/haikostudio/haikodev. Der Zugang ist derzeit beschränkt: Öffnen Sie es im Browser, und wenn GitHub eine „nicht gefunden“-Seite zeigt, wurde Ihr Konto noch nicht eingeladen. Bitten Sie um die Einladung, nehmen Sie sie an und laden Sie die Seite neu — Sie müssen die Dateiliste sehen.

    Danach muss sich auch Ihre Maschine verbinden können. Am einfachsten geht das mit dem offiziellen Werkzeug von GitHub:

    Die Maschine mit GitHub verbinden
    gh auth login    # den Fragen folgen: GitHub.com, HTTPS, Anmeldung über den Browser
gh auth status   # muss bestätigen, dass Sie angemeldet sind

  2. Den Code holen

    Wechseln Sie dorthin, wo das Projekt liegen soll — im Beispiel das persönliche Verzeichnis — und klonen Sie dann das Repository. Dieser Befehl lädt den gesamten Code herunter und behält die Verbindung zu GitHub, wodurch spätere Aktualisierungen mit einer einzigen Zeile möglich werden.

    Das Repository klonen
    cd ~
git clone https://github.com/haikostudio/haikodev.git haikodev
cd haikodev

    Sie möchten lieber ein einfaches Archiv, ohne Verbindung zu GitHub? Die Schaltfläche Code → Download ZIP auf der Repository-Seite tut dasselbe. Sie müssen es dann bei jeder Aktualisierung neu herunterladen, was schnell mühsam wird.

  3. Die Abhängigkeiten installieren

    Das Projekt stützt sich auf Bibliotheken, die einmal heruntergeladen werden müssen. Achtung, eine klassische Falle: Wenn Ihr Server bereits erklärt, „in Produktion“ zu laufen, überspringt die Installation die Werkzeuge für den Build, und der nächste Schritt scheitert mit einem tsc: not found. Der folgende Befehl erzwingt ihre Installation.

    Installieren
    NODE_ENV=development npm install --include=dev

  4. Das Programm bauen

    Der Quellcode wird in ein ausführbares Programm übersetzt: zuerst die gemeinsamen Regeln, dann der Server, dann die Oberfläche. Rechnen Sie mit ein bis zwei Minuten.

    Bauen
    npm run build

  5. Ihre Zugangsdaten anlegen

    Der Zugang zum Board ist durch einen Benutzernamen und ein langes Passwort geschützt. Ein Skript erzeugt beides und zeigt es genau einmal an: Notieren Sie es sofort, es erscheint kein zweites Mal.

    Den Zugang anlegen
    node scripts/set-credentials.mjs

  6. Einmal von Hand starten

    Bevor daraus ein dauerhafter Dienst wird, prüfen Sie, ob alles hochkommt. Das Programm lauscht lokal auf Port 7070; öffnen Sie http://127.0.0.1:7070 von derselben Maschine aus (oder über einen SSH-Tunnel von Ihrem Rechner) und melden Sie sich mit den Daten aus dem vorigen Schritt an.

    Starten
    npm start

    Sie sehen die Anmeldewand und danach das leere Board? Dann hat es geklappt. Beenden Sie das Programm mit Ctrl+C: Jetzt machen wir es dauerhaft.

  7. Dauerhaft laufen lassen

    Eine Dienstdatei liegt dem Repository bei. Sie weist das System an, HaikoDev beim Hochfahren zu starten und bei einer Panne von selbst neu zu starten.

    Den Dienst installieren
    sudo cp scripts/haikodev.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now haikodev
systemctl status haikodev   # muss „active (running)“ anzeigen

  8. Ihm eine Adresse geben

    HaikoDev lauscht bewusst nur lokal: Von allein ist es nicht im Internet erreichbar. Um vom Handy oder einem anderen Rechner darauf zuzugreifen, stellen Sie einen Webserver davor, der sich um den Domainnamen und das Zertifikat kümmert. Mit Caddy genügen drei Zeilen.

    /etc/caddy/Caddyfile
    haikodev.meine-domain.tld {
	reverse_proxy 127.0.0.1:7070
}

    Laden Sie den Webserver anschliessend neu, und die Adresse antwortet über HTTPS. Genau diese Adresse können Sie auch als App auf Ihrem Handy „installieren“.

  9. Ihre Engines einhängen

    HaikoDev nutzt die Kommandozeilenwerkzeuge, die auf der Maschine bereits angemeldet sind — es gibt keinen Schlüssel, den man in der Oberfläche eintippt, und damit nichts, was pro Aufruf abgerechnet wird. Installieren Sie die gewünschten Engines unter demselben Konto wie den Dienst und melden Sie sich an, danach wählen Sie in den Projekteinstellungen die Standard-Engine.

  10. Prüfen, ob alles stimmt

    Das Repository bringt eigene Prüfungen mit. Die erste geht Regeln, Vorlagen und Abrechnung durch; die zweite öffnet einen echten Browser und klickt sich durch die Oberfläche. Die dritte räumt die dabei erzeugten Testkarten weg: Starten Sie sie immer danach, damit das Board das Ihrer eigenen Arbeit bleibt.

    Prüfen
    npm test
node scripts/verify-ui.mjs
node scripts/nettoyer-essais.mjs

Später aktualisieren

Eine neue Version ist erschienen? Fünf Zeilen, immer dieselben, aus dem Projektverzeichnis. Nichts von dem, was Sie angelegt haben, wird gelöscht: Ihre Projekte, Ihre Karten und Ihre Einstellungen liegen im Datenverzeichnis, neben dem Code.

Aktualisieren
cd ~/haikodev
git pull
NODE_ENV=development npm install --include=dev
npm run build
sudo systemctl restart haikodev

Wenn etwas klemmt

Der Dienst startet und hört sofort auf

In neun von zehn Fällen passt ein Pfad oder ein Benutzer in der Dienstdatei nicht. Die Protokolle sagen es deutlich: journalctl -u haikodev -n 50.

Der Build bricht mit „tsc: not found“ ab

Das ist die Falle aus Schritt 3: Die Build-Werkzeuge wurden nicht installiert. Starten Sie die Installation erneut mit NODE_ENV=development npm install --include=dev, dann npm run build.

GitHub verweigert das Klonen

Entweder ist Ihre Maschine nicht angemeldet, oder Ihr Konto hat noch keinen Zugang zum Repository. gh auth status beantwortet die erste Frage, die Repository-Seite im Browser die zweite.

Sobald das Board online ist, wird es einfach: Legen Sie ein Projekt an, beschreiben Sie Ihren ersten Bedarf in normaler Sprache und lassen Sie sich vom Dirigenten eine Karte vorschlagen. Ausführlich erzählt wird das in Ihre erste Karte, von der Anfrage bis zur Veröffentlichung.