Einstellungen vollständig erklärt

Dateien und Ladeablauf

Globale Benutzerkonfiguration: ~/.lurus/settings.json. Projektkonfiguration: <cwd>/.lurus/settings.json. Verlassen Sie sich nicht auf eine zusätzliche settings.local.json-Ebene. Verwenden Sie JSON ohne Kommentare. Erhalten Sie bei Änderungen bestehende Werte und überschreiben Sie vorhandene Dateien nicht ungeprüft mit Beispielen.

Die CLI lädt zunächst Standardwerte, dann globale Dateien und Projektdateien. LURUS_API_URL und LURUS_MODEL können die entsprechenden Dateiwerte überschreiben. Ausführbare Einstellungen und Freigaben werden erst nach der erforderlichen Zustimmung aktiv.

Projektwerte haben nicht pauschal Vorrang. Anzeigeoptionen können direkt übernommen werden; Verbote werden ergänzt. Ausführung, Freigaben und Hilfsmodelle benötigen Zustimmung. Gleichnamige MCP-Serverobjekte ersetzen sich vollständig, statt feldweise zusammengeführt zu werden. /config zeigt die bereits geladene Konfiguration. Es unterstützt weder set, get noch reset und lädt manuelle Änderungen nicht neu. Starten Sie dafür eine neue CLI-Sitzung.

In den Tabellen bedeutet G global, P direkt Projektwert ohne zusätzliche Zustimmung, P Zustimmung Projektwert erst nach Zustimmung und P ignoriert beim normalen Laden nicht übernommener Projektwert. Modellabhängige Unterstützung und ausdrücklich gesetzte CLI-Optionen gelten zusätzlich.

Minimale Projektkonfiguration

.lurus/settings.json:

{
  "displayCost": true,
  "permissions": {
    "allow": [],
    "deny": [],
    "allowedCommands": ["git status"],
    "deniedCommands": ["git push"],
    "bashAutoApprove": false
  }
}

Die Kostenanzeige wird direkt übernommen. Freigaben benötigen Zustimmung; allowedCommands erlaubt nur den exakt angegebenen Bashbefehl, nicht beliebige strukturierte Prozessaufrufe. git push ergänzt die Sperren. Nach dem Neustart prüfen Sie die geladenen Werte und Freigabeangebote; das Beispiel erlaubt nicht sämtliche Gitbefehle.

Globales Gegenstück ~/.lurus/settings.json:

{
  "disableDangerousTrust": true,
  "indexing": false,
  "permissions": {
    "allow": [],
    "deny": [],
    "allowedCommands": ["git status"],
    "deniedCommands": ["git push"],
    "bashAutoApprove": false
  }
}

disableDangerousTrust und indexing werden hier global gesetzt. Beim normalen Laden der Projektkonfiguration werden dieselben Felder ignoriert; dort bieten sie deshalb keinen dauerhaften Schutz.

Alle Konfigurationsfelder

Die Typangaben string, number und boolean stehen für Text, Zahl und Wahrheitswert. Standardwerte gelten, soweit nicht anders angegeben, bei fehlender Einstellung.

Verwenden Sie für optionale Modellfelder eine tatsächliche Auswahl aus /model.

Outputkürzung und Indexneustart

Ohne truncateToolOutput gelten je nach Werkzeug unterschiedliche Zeichenlimits: 40.000 für Lesen, Shellausgabe und Webinhalte, 25.000 für Text- und semantische Suche, 10.000 für Datei- und Verzeichnislisten, 80.000 für Unteragentantworten und 8.000 für andere Ausgaben. Gewöhnliche Toolausgaben werden außerdem dynamisch auf 5.000 bis 80.000 Zeichen begrenzt; Unteragentantworten und Plandokumente sind von dieser Reduktion ausgenommen.

/indexing on|off ändert die aktuelle Einstellung und speichert einen Projektwert. Dieser Wert wird beim normalen Neustart jedoch nicht übernommen. Für einen dauerhaften Opt-out genügt der Slashbefehl nicht. Setzen Sie global "indexing": false und prüfen Sie die Kontoeinstellung. /indexing clear|delete löscht den Index, nicht die Einstellung.

Permissions-Unterfelder

allowedCommands:["git"] erlaubt nicht beliebige Gitbefehle. git status --short ist nicht der String git status. Prüfungen zu Skripten, Arbeitsverzeichnis, Secrets und gefährlichen Aktionen gelten weiterhin. Details: Berechtigungen.

Verlassen Sie sich bei bashAutoApprove nicht auf einen universellen Standardwert. Die aktive Wirkung hängt von den geladenen Regeln und der erteilten Zustimmung ab.

Wichtig: Ein Projektwert false ist kein dauerhaftes Veto gegen einen genehmigten globalen Wert true. Setzen Sie zum Schutz bashAutoApprove bewusst global auf false und prüfen oder widerrufen Sie bestehende Freigaben.

MCP-Unterfelder

Alle Felder unter mcpServers.<name>, vollständiger MCP-Ablauf:

Ein Projektserver ersetzt ein gleichnamiges Globalobjekt komplett. Wird die Projektquelle abgelehnt, ist kein Start des globalen Ersatzservers garantiert.

Hook-Unterfelder

hooks|globalHooks|projectHooks.<Event>: Definition[]; Definition mit optionalem matcher:string und hooks:Action[]:

• Commandaction: type:"command", command:string, optional timeout:number ms.
• HTTPaction: type:"http", url:string, optional method:"POST"|"PUT"|"PATCH", headers:Record<string,string>, timeout:number.
• Das Timeout beträgt standardmäßig 30.000 ms, die HTTP-Methode ist POST. Eine separate hooks.json enthält direkt die Eventzuordnung.

Hooks beschreibt vollständige Beispiele, unterstützte Events, Headerverbote, Matcher und die Grenzen bei Fehlern.

Fortgeschrittene Projektszenarien

.lurus/settings.json für vorhandene geprüfte npm-Skripte:

{
  "autoLint": true,
  "autoTest": "npm run test:unit",
  "displayCost": true
}

Nach Zustimmung zum Projekt werden die vorhandenen Skripte lint und test:unit im Prüfworkflow verwendet. Prüfen Sie npm-Lifecycle, Arbeitsverzeichnis und Skriptinhalt; Änderungen können eine neue Freigabe erfordern. Erstellen Sie keine Umgehungsskripte für verweigerte Operationen.

Ermitteln Sie für modelAliases zuerst die öffentliche Auswahl mit /model. Die Objektform ist {"my-review":"<selected-public-model>"}; ersetzen Sie den Platzhalter vor Verwendung. Projektaliase benötigen Zustimmung und ergänzen globale Aliase nach Namen. Der Projektwert für model selbst wird dagegen nicht übernommen.

Verwaltete Werte und Altlasten

Verwalten Sie Skillaktivierung mit /skills activate|deactivate und Agentfreigaben mit /agents trust|untrust, statt gespeicherte Verwaltungsdaten von Hand zu ändern. Eingebaute Skills sind standardmäßig aktiv.

• Wählen Sie den Interaktionsmodus über ein CLI-Flag oder /mode, nicht durch manuelles Setzen von mode in der Datei.
• permissionMode ist eine Prozessoption, kein unterstützter Settingsschlüssel.
• disableBypassPermissions ist ein älterer globaler Alias für disableDangerousTrust; verwenden Sie in neuen Konfigurationen letzteres.
• costWarningThreshold wird ignoriert; verwenden Sie costLimit.
• lurus.config.json, .lurusrc, allowedPaths, blockedPaths, requireConfirmation, beforeWrite und afterCommit sind keine aktuelle CLI-Konfiguration.

Schema und öffentliche Umgebung

Das lokale Settingsschema beschreibt nicht alle unterstützten Optionen und Standardwerte vollständig. Verlassen Sie sich nicht allein auf dessen Validierung oder eine vermeintlich öffentliche $schema-URL. Nutzen Sie die hier beschriebenen Feldtypen und Geltungsbereiche.

Fehlersuche und Automation erklären die sichere Verwendung.