Pi Agent CLI-Referenzhandbuch
Das Folgende ist eine Referenz für gängige Pi Agent Kommandozeilenparameter.
Modusoptionen
Die folgenden Parameter steuern den Ausführungsmodus von Pi Agent. Wenn nicht angegeben, wird standardmäßig die interaktive Oberfläche aufgerufen.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| (Standard) | Interaktiver Modus, Terminal-TUI-Oberfläche | Pi |
| -p, --print | Print-Modus, beendet sich nach Ausgabe des Ergebnisses | pi -p "summarize code" |
| --mode json | JSON-Modus, alle Ereignisse werden als JSON-Zeilen ausgegeben | pi --mode json -p "summarize" |
| --mode rpc | RPC-Modus, stdin/stdout-JSONL-Protokoll | pi --mode rpc |
| --export <input> [output] | Sitzung als HTML exportieren; Ausgabepfad kann weggelassen werden | pi --export abc123 session.html |
Modelloptionen
Die folgenden Parameter dienen zur Angabe von Anbieter, Modell und Reasoning-Level; geeignet für temporäres Umschalten ohne Änderung der Konfigurationsdateien.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| --provider name | KI-Anbieter angeben | pi --provider anthropic |
| --model pattern | Modell-ID, unterstützt die Formate provider/id und :thinking | pi --model openai/gpt-4o pi --model sonnet:high |
| --api-key key | Übergeben Sie den API-Schlüssel direkt, mit der höchsten Priorität; ersetzen Sie den Beispielwert durch Ihren eigenen Schlüssel | pi --api-key sk-ant-api03-xxxx |
| --thinking level | Reasoning-Stufe: off/minimal/low/medium/high/xhigh/max | pi --thinking high |
| --models patterns | Kommagetrennte Modellliste, begrenzt das Durchschalten mit Ctrl+P | pi --models "claude-*,gpt-4o" |
| --list-models | Alle verfügbaren Modelle auflisten | pi --list-models |
Sitzungsoptionen
Die folgenden Parameter bestimmen, welche Sitzung in diesem Lauf verwendet wird und wo Sitzungsdateien gespeichert werden.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| -c, --continue | Die letzte Sitzung fortsetzen | pi -c |
| -r, --resume | Historische Sitzung durchsuchen und auswählen | pi -r |
| --session path|id | Eine angegebene Sitzungsdatei oder UUID verwenden | pi --session abc123 |
| --fork path|id | Eine neue Sitzung von der angegebenen Sitzung abzweigen | pi --fork abc123 |
| --session-dir dir | Benutzerdefiniertes Verzeichnis für die Sitzungsspeicherung; das Standardverzeichnis ist ~/.pi/agent/sessions/, dieser Parameter ersetzt es vorübergehend | pi --session-dir .pi/sessions |
| --no-session | Temporärer Modus, Sitzungen werden nicht gespeichert | pi --no-session |
| -n, --name name | Anzeigenamen der Sitzung festlegen | pi --name "Refactor authentication module" |
Tool-Optionen
Die folgenden Parameter steuern die Verfügbarkeit integrierter Tools; sie dienen dazu, Berechtigungen einzuschränken oder reine Konversation zu ermöglichen.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| -t, --tools list | Angegebene Tools auf die Positivliste setzen, kommagetrennt | pi --tools read,bash,edit,write |
| -xt, --exclude-tools list | Angegebene Tools deaktivieren, kommagetrennt | pi --exclude-tools bash |
| -nbt, --no-builtin-tools | Alle integrierten Tools deaktivieren, Erweiterungs-Tools beibehalten | pi --no-builtin-tools |
| -nt, --no-tools | Alle Tools deaktivieren, reiner Konversationsmodus | pi --no-tools |
Ressourcenoptionen
Die folgenden Parameter steuern das Laden von Erweiterungen, Skills, Vorlagen und Themes. Parameter mit dem Präfix --no- werden verwendet, um die automatische Erkennung zu deaktivieren.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| -e, --extension source | Eine Erweiterung laden, kann wiederholt verwendet werden | pi -e ./my-ext.ts -e npm:@foo/bar |
| --no-extensions | Automatische Erkennung von Erweiterungen deaktivieren | pi --no-extensions |
| --skill path | Lädt einen Skill, kann wiederholt verwendet werden | pi --skill ./my-skill |
| --no-skills | Deaktiviert die automatische Skill-Erkennung | pi --no-skills |
| --prompt-template path | Lädt eine Prompt-Vorlage, kann wiederholt verwendet werden | pi --prompt-template ./review.md |
| --no-prompt-templates | Deaktiviert die automatische Vorlagenerkennung | pi --no-prompt-templates |
| --theme path | Ein Theme laden, kann mehrfach verwendet werden | pi --theme ./my-theme.json |
| --no-themes | Automatische Theme-Erkennung deaktivieren | pi --no-themes |
| -nc, --no-context-files | Laden von AGENTS.md/CLAUDE.md deaktivieren | pi -nc |
Weitere Optionen
Die folgenden Parameter überschreiben Verhaltensweisen wie System-Prompt, Projektvertrauen und Hilfeinformationen.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| --system-prompt text | Ersetzt den Standard-System-Prompt | pi --system-prompt "Du bist ein Python-Experte" |
| --append-system-prompt Text | An den System-Prompt anhängen | pi --append-system-prompt "Antworte auf Chinesisch" |
| --tui-mode | Schnittstellenmodus, z. B. fullscreen; falls nicht angegeben, wird der normale Modus verwendet | pi --tui-mode fullscreen |
| --use-theme | Legt ein zu ladendes Theme fest; nur für den aktuellen Lauf wirksam, ändert die Konfiguration nicht | pi --use-theme "dark-plus" |
| --verbose | Erzwingt die Anzeige detaillierter Startinformationen | pi --verbose |
| -a, --approve | Projektlokalen Dateien für diesen Lauf vertrauen | pi -a |
| -na, --no-approve | Projektlokalen Dateien für diesen Lauf nicht vertrauen | pi -na |
| -- | Trennzeichen; der Inhalt danach wird unverändert an den Prompt übergeben | pi -- @notes.md Fasse diese Notiz zusammen |
| -h, --help | Hilfeinformationen anzeigen | pi -h |
| -v, --version | Versionsnummer anzeigen | pi -v |
-aund-naSchließen sich gegenseitig aus; es kann nur eines im selben Lauf angegeben werden.
Beide sind nur auf den aktuellen Lauf beschränkt und werden nicht in trust.json geschrieben.
pi-Unterbefehle
Zusätzlich zu Startparametern bietet pi auch eine Reihe von Unterbefehlen zur Verwaltung von Erweiterungspaketen und seinen eigenen Updates.
| Unterbefehl | Beschreibung |
|---|---|
| pi install <source> | Ein Erweiterungspaket installieren; -l hinzufügen, um es lokal im Projekt zu installieren |
| pi remove <source> | Ein installiertes Erweiterungspaket entfernen |
| pi uninstall <source> | Alias für remove, gleiche Wirkung |
| pi list | Installierte Erweiterungspakete auflisten |
| pi update | Aktualisiert pi selbst und Erweiterungspakete; unterstützt --self, --all, --models, --extensions, --extension <source> |
| pi config | Verschiedene von Erweiterungspaketen bereitgestellte Ressourcen aktivieren oder deaktivieren |
Zugehörige Umgebungsvariablen
Die folgenden Umgebungsvariablen beeinflussen Authentifizierung, Netzwerk- und Terminalverhalten und können als ergänzende Konfiguration über die Befehlszeilenparameter hinaus dienen.
| Variable | Zweck | Beispiel |
|---|---|---|
| ANTHROPIC_API_KEY | Alternative Methode zur Anthropic-Authentifizierung; wird verwendet, wenn man nicht über das /login-Abonnement angemeldet ist | sk-ant-api03-xxxx |
| HTTP_PROXY / HTTPS_PROXY | Einen Proxyserver für API-Anfragen angeben | http://127.0.0.1:7890 |
| NO_PROXY | Proxy-Whitelist; übereinstimmende Hosts werden nicht über den Proxy geleitet | localhost,127.0.0.1 |
| COLORTERM | Einer der Referenzwerte für die Truecolor-Auto-Erkennung; falls die Erkennung fehlschlägt, verwenden Sie PI_TRUE_COLOR=1, um die Aktivierung zu erzwingen, oder konfigurieren Sie terminal.trueColor | truecolor |
Für Proxys, die langfristig verwendet werden sollen, wird empfohlen, den Wert in~/.pi/agent/settings.jsonunterhttpProxy zu schreiben。
Diese Konfiguration wird nur in der globalen Konfigurationsdatei wirksam; das Schreiben auf Projektebene.pi/settings.jsonist ungültig.
Dateiargumente
Verwendung@Präfix zum Referenzieren von Dateien:
$ pi @prompt.md "回答这个问题" $ pi -p @screenshot.png "图中有什么" $ pi @src/code.ts @src/test.ts "对比这两个文件"
Am Beispiel des zweiten Befehls sieht die Ausgabe ähnlich aus wie:
The image is a screenshot of a login page, which includes a username input field, a password input field, and a login button.Weitere Erweiterungen