Einstieg und Konventionen
Installation und Voraussetzungen finden Sie im Schnellstart. lurus --help, lurus --version und lurus <command> --help zeigen die lokale Hilfe und Version. Es gibt keinen zusätzlichen help-Befehl.
D bezeichnet eine direkte Aktion, P einen Agentauftrag und D+P eine direkte Voraktion mit anschließendem Auftrag. Direkte Aktionen können Kosten, Netzwerkzugriffe und Dateiänderungen verursachen. Ersetzen Sie Platzhalter durch tatsächliche Werte; übersetzen Sie die Befehlssyntax nicht.
Hinweise zu Proxies und Zertifikaten finden Sie unter Diagnose, zur Konfiguration unter Einstellungen und Berechtigungen.
Auth und Verwaltung
| Befehl | Optionen | Wirkung |
|---|---|---|
lurus login | --api-key, --email, jeweils ohne Wert. | Standardmäßig Browseranmeldung; alternativ interaktive Eingabe. Bei beiden Flags gilt API-Schlüssel-Eingabe. Keine Zugangsdaten als Argumente übergeben. |
lurus register | Keine. | Registriert über den Browser und speichert Zugangsdaten. |
lurus logout | --all | Entfernt gespeicherte Anmeldung und versucht bei JWT die serverseitige Abmeldung einer oder aller Sitzungen. Widerruft keine API-Schlüssel und entfernt keine Umgebungsvariablen. |
lurus status | Keine. | Zeigt Anmeldequelle, Profil und Proxyinformationen. |
lurus doctor | Keine. | Prüft die Umgebung auch ohne Anmeldung. |
lurus update | --check | Prüft mit --check die Version und kann den Cache schreiben. Sonst installiert es eine neuere Version global über npm; Entwicklungsbuilds installieren nicht. |
Behandelte Fehler und Abbrüche enden nicht immer mit einem Fehlercode. Prüfen Sie die Ausgabe; eine Erfolgsmeldung garantiert keinen serverseitigen Widerruf. Details: Fehlersuche.
Chat und Einmalprompt
chat ist der Standardbefehl. Ein Beispiel ist lurus chat --mode ask --prompt "Explain the project".
Gefahr: dangerouslySkipAllPermissions deaktiviert Freigabeprüfungen ohne den interaktiven Bestätigungsdialog von /trust on, sofern nicht global gesperrt. Verwenden Sie diesen Modus nicht als Standard.
| Option | Werte und Wirkung |
|---|---|
-m, --model <model> | Öffentliche Modellauswahl oder Alias. |
-p, --prompt <prompt> | Führt einen Einzelprompt aus. Auch lurus chat [prompt...] ist möglich. |
--max-turns <n> | Positive, sicher darstellbare Ganzzahl aus Dezimalziffern. Begrenzt Modellanfragen des Hauptagenten einschließlich Wiederholungen. Nur für Einzelprompts, nicht interaktiv oder mit --pipe; ungültige Kombinationen enden vor Anmeldung mit Exitcode 1. |
-c, --continue | Lädt die letzte Sitzung. |
-r, --resume <id> | Lädt die angegebene Sitzung. |
--pipe | Startet eine langlebige Integration über stdin und stdout. |
--output-format <format> | Standardmäßig text; alternativ stream-json oder json. Beide JSON-Varianten liefern NDJSON, kein einzelnes abschließendes Objekt. |
--add-dir <dirs...> | Nimmt zusätzliche Verzeichnisse auf; Freigaberegeln gelten weiterhin. |
--from-pr <number> | Versucht zuerst git diff origin/main...HEAD, nur bei Fehler gh pr diff <number>. Höchstens 50.000 Zeichen; nicht garantiert der angegebene PR. |
--json-schema <path> | Ergänzt den Prompt um Schemaanweisungen; keine automatische Antwortvalidierung. Bei Lesefehlern wird gewarnt und fortgesetzt. |
--permission-mode <mode> | default, acceptAllEdits oder dangerouslySkipAllPermissions. Nicht mit dem Interaktionsmodus verwechseln. |
--thinking <mode> | on, adaptive oder off, soweit vom Modell unterstützt. |
--effort <level> | minimal, low, medium, high, xhigh oder max; vor Anmeldung geprüft. |
--max-mode <on|off> | Setzt den Max-Modus ausdrücklich. |
--mode <mode> | agent, ask oder plan. |
--debug | Startet den Debug-Interaktionsmodus. |
Einzelprompts speichern die Sitzung und enden mit Exitcode 0 oder 1. Verwenden Sie für maschinelle Ausgabe --output-format json mit getrenntem Wert; Kurz- und =-Schreibweisen aktivieren nicht dieselbe Logumleitung. Details: Sitzungen und Automation.
Batch
Achtung: Batch kann Dateien ändern und Prozesse ausführen. Ein Lesewunsch im Prompt erzwingt keinen Schreibschutz.
lurus batch prompts.txt --output-format json --continue-on-error
Optionen sind -m/--model <model>, -o/--output-format <text|json>, --continue-on-error und --max-turns <n>. Standardmäßig wird Text ausgegeben und beim ersten Fehler gestoppt. Das Rundenlimit begrenzt die Modellanfragen einschließlich Wiederholungen pro Prompt und benötigt dieselbe Ganzzahlform wie oben. --- auf einer eigenen Zeile trennt Promptblöcke; einzelne Zeilen sind nicht automatisch einzelne Prompts. Zwischen Prompts wird der Verlauf geleert. Fehler führen auch bei Fortsetzung zu Exitcode 1; eine leere Liste endet mit 0. Details: Batchdatei und JSON-Ausgabe.
MCP-Kommandos
| Syntax | Optionen und Wirkung |
|---|---|
lurus mcp add <name> | Genau eines von --command <cmd> oder --url <url>. Weitere Optionen: --type <stdio|http|sse>, --args <args...>, --env <pairs...>, --cwd <path>, --header <pairs...>, --timeout <ms>, --trust, --project. Ohne Projektflag global; Remote-Typ standardmäßig http. Timeout als positive ganze Millisekunden. Speichert, startet aber nicht. |
lurus mcp remove <name> | Optional --project; entfernt Konfiguration und Headerreferenzen. Unbekannte Einträge oder Fehler enden mit Exitcode 1. |
lurus mcp list | Listet globale und Projektserver, ohne eigene Optionen. |
add kann gleichnamige Konfiguration überschreiben. Prüfen Sie vorhandene Einträge und Skripte vor der Ausführung. Umgebung, Argumente und Arbeitsverzeichnis gelten lokal, Header remote; Paare verwenden KEY=VALUE. Beispiel: lurus mcp add local-docs --command node --args /absolute/path/server.mjs --project. Details: MCP.
CI/CD und versteckte Integration
Hier sind die öffentlichen CI-Befehle aufgeführt. Reports können Dateien überschreiben. Scans können Kosten verursachen und Code übertragen; PR-Aktionen sind extern sichtbar.
| Befehl | Eigene Flags |
|---|---|
lurus security-ci | -m/--model <model>, -f/--format <sarif|json|html|text> (Standard sarif), -o/--output <path> (Standard lurus-security-results.sarif), --fail-on <severity> (Standard high), --diff, --diff-base <ref> (Hilfe nennt HEAD), --no-upload, --pr-comments, --comment-min-severity <severity> (Standard medium). |
lurus code-review-ci | -m/--model <model>, -f/--format <json|html|text> (Standard json), -o/--output <path> (Standard lurus-code-review-results.json), --fail-on <severity> (Standard high), --full, --staged, --diff-base <ref>, --pr-comments, --verdict, --comment-min-severity <severity> (Standard medium). |
Schweregrade sind critical, high, medium, low und info; ungültige Werte fallen auf high zurück. Exitcodes: 0 bei bestandener Prüfung, 1 bei blockierenden Befunden oder fehlender Berechtigung, 2 bei Ausführungsfehlern, 3 bei erschöpftem Guthaben. --no-upload verhindert den Befundupload, nicht Modellanfragen. Beispiele und Grenzen: CI/CD.
Alle Slashbefehle
Sessions und Aufgaben
Achtung: /sessions delete <id> löscht ohne weiteren Dialog. /build-plan beauftragt die Umsetzung, nicht nur eine Vorschau. Prüfen Sie IDs und Pläne zuerst.
| Syntax | Wirkung |
|---|---|
/resume [Suchtext...] | D: Listet bis zu 20 Projektsitzungen, lädt sie nicht. |
/sessions [all|delete <id>] | D: Listet bis zu 50 Projekt- oder alle Sitzungen. Löscht mit delete; ohne ID wird die Liste angezeigt. |
/recall <Suchtext...> / /recall --load <id> | D: Sucht oder lädt projektübergreifend. Ein anderes Projekt erfordert Bestätigung, standardmäßig Nein. |
/clear | D: Leert den Chat, nicht Aufgabe oder Dateien. |
/task new / /task status | D: Beginnt eine neue Aufgabe oder zeigt ihren Status. |
/build-plan <Pfad...> | D+P: Aktiviert den Plan und beauftragt die Umsetzung im Agentmodus. |
/save [Pfad] | D: Markdown-Export, ohne Pfad mit Zeitstempel. Externe Pfade und Überschreiben benötigen Zustimmung. |
/rewind chat | D: Nimmt Nachrichten zurück, keine Dateiänderungen. |
/quit, /exit | D: Beendet die Sitzung. |
Details: Chat und Sitzungen.
Modelle und Modi
| Syntax | Wirkung |
|---|---|
/model [Name/Alias] | D: Zeigt die öffentliche Auswahl oder setzt sie sofort und global. Kein clear oder reset. |
/utilitymodel [Name/Alias|clear] | D: Ändert das globale Hilfsmodell oder entfernt den eigenen Wert; Neustart erforderlich. |
/compactionmodel [Name/Alias|clear] | D: Ändert die globale Komprimierungsauswahl; Neustart erforderlich. |
/mode [agent|plan|ask|debug] | D: Zeigt oder wechselt den Sitzungsmodus; standardmäßig agent. |
/agent [Auftrag...], /plan [Auftrag...], /ask [Auftrag...], /debug [Auftrag...] | D/D+P: Wechselt ohne Text nur den Modus, mit Text auch Auftrag. Debug startet keine automatische Diagnoseaufzeichnung. |
/max | D: Schaltet um und speichert global; angehängtes on oder off setzt nicht ausdrücklich. |
/thinking [on|adaptive|off] | D: Aktuelle und globale Einstellung; standardmäßig on. Dauerhaftes Denken ist nicht abschaltbar. |
/effort [minimal|low|medium|high|xhigh|max] | D: Standardmäßig high; Unterstützung modellabhängig. |
/costsaving [on|off] | D: Zeigt Status oder setzt ausdrücklich; standardmäßig an, kein Umschalten ohne Wert. |
/displaycost [on|off] | D: Aktuelle und globale Anzeige, standardmäßig aus; Kostenerfassung bleibt unabhängig. |
Details: Modelle und Kosten und Einstellungen.
Kontext und Konfiguration
Achtung: /rules create kann Dateien überschreiben. Reparatur setzt beschädigte globale Freigabedaten für alle Projekte zurück, mit Backup und Bestätigung. /trust on deaktiviert Prüfungen und verlangt eine exakte Risikobestätigung; verwenden Sie stattdessen enge Freigaben.
| Syntax | Wirkung |
|---|---|
/context | D: Zeigt die Tokenaufschlüsselung. |
/copy | D: Kopiert die letzte Agentantwort in die Zwischenablage. |
/paste | D: Speichert und hängt ein Bild aus der Zwischenablage an, ohne Prompt. |
/detach [Index|Namefragment], Alias /drop | D: Entfernt Referenzen, nicht Dateien. Ohne Argument alle. |
/compress, Alias /compact | D: Komprimiert den Kontext; Detailverlust möglich. |
/refresh, Alias /reindex | D: Erneuert den @-Dateisuchcache, nicht den semantischen Index. |
/indexing [on|off|clear|delete|rebuild] | D: Zeigt Status, ändert die aktuelle Einstellung oder löscht beziehungsweise erneuert den Index. Projektwerte überstehen einen Neustart nicht zuverlässig. |
/config | D: Zeigt geladene Konfiguration; kein set, get, reset oder Reload. |
/init | D+P: Erstellt eine Grundstruktur und beauftragt Analyse und Ergänzung. |
/rules [list|show <Name>|create [Name]] | D: Listet, zeigt oder erstellt Projektregeln. Standardname new-rule; Neustart nach Änderungen. |
/permissions | D: Zeigt Quellen, IDs und Geltungsbereiche. |
/permissions revoke <id> / /permissions clear | D: Entfernt dauerhafte Projektfreigaben. |
/permissions revoke session <id> / /permissions revoke settings <id> / /permissions revoke global-settings | D: Widerruft die jeweilige Quelle. Settings-JSON bleibt bestehen. |
/permissions repair / /permissions repair trust | D: Repariert beschädigte globale Berechtigungs- oder Freigabedaten; Bestätigung standardmäßig Nein. |
/trust [on|off] | D: Zeigt Status, deaktiviert Prüfungen mit on oder stellt sie mit off wieder her. Global sperrbar. |
Details: Kontext, Regeln, Einstellungen und Berechtigungen.
Erweiterungen
Achtung: Generatoren und Updates können Dateien überschreiben; /memory clear löscht ohne weiteren Dialog. Prüfen Sie Quellen, Namen und Zielpfade vor der Ausführung.
| Syntax | Wirkung |
|---|---|
/commands | D: Zeigt geladene Vorlagen, ohne Verwaltungs- oder Reloadunterbefehle. |
/agents, /agents list | D: Listet eigene Agenten. |
/agents show <key> | D: Zeigt Metadaten und Pfad, nicht den vollständigen Prompt. |
/agents trust <key>, /agents untrust <key> | D: Speichert oder entfernt Vertrauen für Quelle und Dateiinhalt. |
/agents run <key> <prompt...> | D: Startet einen eigenen Agenten; Vertrauen wird geprüft, Teilresultate sind möglich. |
/skills, /skills show <key> | D: Lädt Skills neu und zeigt Liste oder Inhalt. |
/skills activate <key>, /skills deactivate <key> | D: Dauerhafte, quellenbezogene Aktivierung oder Sperre eingebauter Skills. |
/skills activate-session <key>, /skills deactivate-session <key> | D: Temporäre Änderung; dauerhafte Sperren bleiben. |
/skills audit | D: Prüft kurze Inhalte und doppelte Namen, keine Sicherheitsprüfung oder Neuladung. |
/skillify | P: Beauftragt Fragen, Prüfung und Erstellung nützlicher Skills. |
/create-hook <event> <name> [--ts] | D: Generiert Projektdateien; TypeScript benötigt npx tsx. |
/hooks validate | D: Prüft einen Teil der Projektkonfiguration. |
/mcp, /mcp restart <server>, /mcp refresh-tools | D: Zeigt Status, verbindet neu oder erneuert Tooldefinitionen. Neustart allein aktualisiert diese nicht. |
/memory, /memory clear, /memory edit, /memory sweep | D: Zeigt, löscht, bearbeitet oder konsolidiert Memory. |
/install, /install list, /install remove <package>, /install update [package], /install [bundle] <sources...> | D/D+P: Hilfe, Paketliste, bestätigte Entfernung oder Installation mit Kopierauftrag. Update ohne Namen ist nur ein Agentauftrag. |
Beispiele: Eigene Befehle, Agenten, Skills, Hooks, MCP und Memory.
Tools, Analysen und Git
Achtung: Undo stellt ältere Inhalte in agentbetroffenen Pfaden ohne weiteren Dialog wieder her; eigene spätere Änderungen dort können betroffen sein. Prüfen Sie zuerst /undo list und sichern Sie eigene Änderungen. Git- und PR-Aktionen sind nicht aus einer Lesefrage abzuleiten.
| Syntax | Wirkung |
|---|---|
/tools [desc] | D: Listet Tools nach Modus und Tarif, schaltet sie nicht um. |
/web <url> | D+P: Lädt bis zu 30.000 Zeichen und fordert eine Zusammenfassung an. |
/test gen|generate [Ziel] | P: Ab Pro Tests schreiben, ausführen und korrigieren; standardmäßig Projekt. |
/docs [Ziel] | P: Ab Pro Dokumentation; standardmäßig Projekt. |
/tdd on|warn|strict|off, /tdd <Feature> | D/D+P: on entspricht warn; Featuretext setzt strict und beauftragt Red/Green/Refactor. |
/tdd-implement | P: Bestehende Tests erfüllen, Refactoring und Commit; aktiviert selbst keinen Schutz. |
/edit | D+P: Öffnet den Prompteditor; kein /editor-Alias. |
/diff | D: Zeigt Checkpointdiff mit 60-Zeilen-Vorschau. |
/undo [list|all|N] | D: 1 ist der neueste, all der älteste erhaltene Projektcheckpoint. Nur agentbetroffene Pfade; Historie wird gekürzt. Ohne Argument und mit nur einem Checkpoint direkte Wiederherstellung. |
/commit [Nachricht] | D: Optionales Staging nach Bestätigung und Commitdialog, standardmäßig Abbruch; kein Push. |
/create-pr [--draft] [--reviewer <Wert>] [--label <Wert>] | D+P: Prüft GitHub-Voraussetzungen und beauftragt extern sichtbare PR-Erstellung. |
/fix-issue <Nummer> | D+P: Lädt Issue, versucht Branchanlage und beauftragt Korrektur. |
/analyze-issue <Nummer> | D+P: Fordert lesende Analyse an, erzwingt aber keinen Modus. |
/fix-pr | D+P: Lädt Kommentare der aktuellen PR und beauftragt Korrektur; kein Push. |
/security-review, Alias /scan | D: Native Sicherheitsanalyse ab Pro. |
/review, Alias /code-review | D: Native Codeanalyse ab Pro. |
Gemeinsame Analyseflags: --html, --json <path>, --model <selection>, --tier <max|eu|custom> und --provider <eu|anthropic|openai|openai-global|gemini|global|lurus>. Security unterstützt zusätzlich --diff, --diff-base <ref> und --focus <crypto|auth|injection|supply-chain>. Review unterstützt --full, --staged, --diff-base <ref> und --no-prechecks. Details: Workflows.
Medien, Orchestrierung und Info
Achtung: Medien- und Orchestratoraktionen können Kosten verursachen und Dateien schreiben. Reports überschreiben gleichnamige Dateien ohne weiteren Dialog; HTML lädt eine externe Diagrammbibliothek. Prüfen Sie Inhalte vor der Weitergabe.
| Syntax | Wirkung |
|---|---|
/image [--model=<id>] [--aspect=<value>|--size=<WxH>] <prompt>, Alias /img | D: Standardgröße 1024 × 1024 Pixel. /image models [--refresh] zeigt die Auswahl. |
/image-edit [options] <path> <prompt>, Alias /img-edit; alternativ wiederholtes --source=<path> | D: 1–5 geordnete Quellen, neue Ergebnisdatei. |
/video --seconds=<4|8|12> [--portrait|--landscape] [--ref=<path>] <prompt>, Alias /vid | D: Dauer erforderlich, standardmäßig Hochformat, MP4-Ausgabe. |
/orchestrate [options] <prompt> | D: ULTRA erforderlich; kumulatives Budget standardmäßig 20 EUR, mindestens 5 EUR. |
/orchestrate status <id>, /orchestrate resume <id>, /orchestrate abort <id>, /orchestrate budget <id> <total> | D: Laufsteuerung. Budgetänderung nur bei ausstehender Budgetentscheidung; danach eigenes Resume. Abbruch garantiert keine Dateirücknahme. |
/ide, /ide enable, /ide disable | D: Zeigt Status, verbindet oder trennt die IDE. |
/help | D: Statische Hilfe. |
/cost | D: Kosten, Tokens und Cache-Nutzung. |
/stats | D: Dauer, Modell, Runden und Tooldefinitionen. |
/doctor | D: Umgebungsdiagnose. |
/status | D: Sitzung, Budget, Kontext und Proxyinformationen. |
/changelog | D+P: Git-Vergleich und Changelogauftrag. |
/report [--json [filename]] | D: Standardmäßig lurus-report.html, alternativ JSON. Nur Dateiname, kein beliebiger Zielordner. Metadaten und Zähler, kein Transkript. |
/mermaid [Ziel] | P: Diagrammcode, standardmäßig Projektarchitektur. |
Medienoptionen verwenden =; erlaubte Größen und Formate stehen unter Medien. Orchestratorflags: --mode, --max-cost, --model, --planner-model/--analyst-model, --implementer-model/--architect-model, --reviewer-model/--critic-model. Es gibt kein cancel, pause oder start-Unterkommando. Details: Orchestrierung und IDE und Diagnose.
Bedienpfade und sichere Kurzreferenz
Beginnen Sie mit dem Schnellstart, konfigurieren Sie Einstellungen und nutzen Sie Agenten für begrenzte Reviews. Workflows beschreibt Tests und Git, Automation den Maschinenbetrieb. Prüfen Sie Freigaben und unterscheiden Sie direkte Aktionen von Agentaufträgen. Eigene Erweiterungen können zusätzliche Befehle bereitstellen.
Beispielabläufe
Schriftliche Beispiele finden Sie für Anmeldung und ersten Chat, Batch sowie Security und Code Review.