title: "Lokale Entwicklung" date: '2026-07-06T00:00:00+08:00' weight: 10 #

Verwende mise als zentralen Einstiegspunkt für die lokale Entwicklung.

Einrichtung #

mise install
mise run setup

mise run setup bereitet lokale Dateien unter dev/ vor, erstellt Entwicklungstokens und Age-Schlüsseldateien und initialisiert bei Bedarf das Controller-Repository. Vorhandene lokale Dateien werden nicht überschrieben.

App-Stack #

Starte Controller, Agent und Web-UI:

mise run dev

• Controller: http://127.0.0.1:7001
• Web-UI: http://127.0.0.1:5173

Logs verfolgen oder den Stack stoppen:

mise run dev:logs
mise run dev:down

Dokumentation #

Die Dokumentation wird standardmäßig nicht mit dem App-Stack gestartet.

mise run dev:docs # nur Dokumentation auf :5174
mise run dev:all  # App und Dokumentation

Prüfungen #

Führe vor dem Commit die normalen lokalen Prüfungen aus:

mise run check

Langsamere Backend-Prüfungen:

mise run check:full

Protobuf-Generierung #

Generiere nach Änderungen unter proto/** den eingecheckten Protobuf-Code und die API-Dokumentation neu:

mise run gen

Committe die generierten Dateien unter gen/go/, web/src/lib/gen/ und site/content/docs/developer-guide/api/.

E2E #

Führe alle lokalen E2E-Tests gegen den echten Controller- und Agent-Fixture-Stack aus:

mise run e2e