Installation
Für die hier beschriebene CLI-Version benötigen Sie Node.js ab 20.9.0 und npm. Das offizielle Paket heißt @scramble-cloud/lurus-code-cli:
Die Installation verändert die globale npm-Umgebung. Beachten Sie vor der Ausführung die Freigaberegeln Ihrer Umgebung.
npm install -g @scramble-cloud/lurus-code-cli
lurus --version
lurus --help
lurus doctor
Die Dokumentation wurde anhand des Quellstands 2.4.0 geprüft. Das ist keine Aussage über die aktuell auf npm veröffentlichte Version. Beachten Sie bei der Installation die Freigaberegeln Ihrer Umgebung. Hinweise zu Unternehmensproxies und Zertifikaten finden Sie unter Diagnose.
Anmelden
lurus login
Standardmäßig erfolgt die Anmeldung über den Browser mit einem Gerätecode. lurus login --email und lurus login --api-key öffnen alternative interaktive Eingaben. Diese Flags benötigen keinen Wert: Übergeben Sie keine Zugangsdaten als Argumente. Mit lurus register registrieren Sie ein neues Konto im Browser. lurus status zeigt die verwendete Anmeldequelle und das Profil.
Eine bewusst gesetzte Umgebungsvariable LURUS_API_KEY hat Vorrang vor gespeicherten Zugangsdaten. Ein ungültiger Wert führt nicht zum stillen Rückgriff auf die gespeicherte Anmeldung. lurus logout entfernt gespeicherte Zugangsdaten, widerruft aber keine API-Schlüssel und entfernt keine Umgebungsvariable.
Erstes Projekt und erste Aufgabe
Starten Sie im Projektverzeichnis:
lurus chat --mode ask
Explain the current architecture. Read relevant files but do not change anything.
/context
Ask blockiert gewöhnliche Dateiänderungen, aber nicht jede Prozessaktion. Prüfen Sie angeforderte Freigaben, Quellen und Pfade, bevor Sie zustimmen. Für die spätere Umsetzung verwenden Sie /agent <konkreter Auftrag> oder /mode agent.
Hinterlegen Sie Projektanweisungen in LURUS.md oder verwenden Sie /init. Dieser Befehl legt eine Grundstruktur an und beauftragt den Agenten mit Analyse und Ergänzung; er liefert nicht sofort ein vollständig ausgearbeitetes Dokument. Regeln und Memory erklären die Dateipfade und das Laden.
Die wichtigsten Einstiegspunkte
| Aufgabe | Einstieg |
|---|---|
| Befehle/Flags finden | Vollständige Referenz |
| Globale und Projektwerte | Settings |
| Eng freigeben/widerrufen | Permissions |
| Wiederverwendbare Vorlage | Custom Commands |
| Lesender Spezialagent | Custom Agents |
| Checklisten/Skillpakete | Skills |
| Events begleiten/blockieren | Hooks |
| Task/Plan/Sessions | Chat und Sessions |
Nächste Schritte
Beginnen Sie bei eigenen Erweiterungen mit einer minimalen Datei. Starten Sie die CLI neu und prüfen Sie, ob die Erweiterung aufgelistet wird. Ergänzen Sie erst danach Shellbefehle, globale Quellen oder dauerhafte Freigaben. Tests, Git-Aktionen, Pull Requests und Medienfunktionen können Dateien verändern und Netzwerkzugriffe auslösen; lesen Sie dazu Workflows. Für den automatisierten Betrieb finden Sie Hinweise unter Automation und CI/CD.