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.

ParameterBeschreibungBeispiel
(Standard)Interaktiver Modus, Terminal-TUI-OberflächePi
-p, --printPrint-Modus, beendet sich nach Ausgabe des Ergebnissespi -p "summarize code"
--mode jsonJSON-Modus, alle Ereignisse werden als JSON-Zeilen ausgegebenpi --mode json -p "summarize"
--mode rpcRPC-Modus, stdin/stdout-JSONL-Protokollpi --mode rpc
--export <input> [output]Sitzung als HTML exportieren; Ausgabepfad kann weggelassen werdenpi --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.

ParameterBeschreibungBeispiel
--provider nameKI-Anbieter angebenpi --provider anthropic
--model patternModell-ID, unterstützt die Formate provider/id und :thinkingpi --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üsselpi --api-key sk-ant-api03-xxxx
--thinking levelReasoning-Stufe: off/minimal/low/medium/high/xhigh/maxpi --thinking high
--models patternsKommagetrennte Modellliste, begrenzt das Durchschalten mit Ctrl+Ppi --models "claude-*,gpt-4o"
--list-modelsAlle verfügbaren Modelle auflistenpi --list-models

Sitzungsoptionen

Die folgenden Parameter bestimmen, welche Sitzung in diesem Lauf verwendet wird und wo Sitzungsdateien gespeichert werden.

ParameterBeschreibungBeispiel
-c, --continueDie letzte Sitzung fortsetzenpi -c
-r, --resumeHistorische Sitzung durchsuchen und auswählenpi -r
--session path|idEine angegebene Sitzungsdatei oder UUID verwendenpi --session abc123
--fork path|idEine neue Sitzung von der angegebenen Sitzung abzweigenpi --fork abc123
--session-dir dirBenutzerdefiniertes Verzeichnis für die Sitzungsspeicherung; das Standardverzeichnis ist ~/.pi/agent/sessions/, dieser Parameter ersetzt es vorübergehendpi --session-dir .pi/sessions
--no-sessionTemporärer Modus, Sitzungen werden nicht gespeichertpi --no-session
-n, --name nameAnzeigenamen der Sitzung festlegenpi --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.

ParameterBeschreibungBeispiel
-t, --tools listAngegebene Tools auf die Positivliste setzen, kommagetrenntpi --tools read,bash,edit,write
-xt, --exclude-tools listAngegebene Tools deaktivieren, kommagetrenntpi --exclude-tools bash
-nbt, --no-builtin-toolsAlle integrierten Tools deaktivieren, Erweiterungs-Tools beibehaltenpi --no-builtin-tools
-nt, --no-toolsAlle Tools deaktivieren, reiner Konversationsmoduspi --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.

ParameterBeschreibungBeispiel
-e, --extension sourceEine Erweiterung laden, kann wiederholt verwendet werdenpi -e ./my-ext.ts -e npm:@foo/bar
--no-extensionsAutomatische Erkennung von Erweiterungen deaktivierenpi --no-extensions
--skill pathLädt einen Skill, kann wiederholt verwendet werdenpi --skill ./my-skill
--no-skillsDeaktiviert die automatische Skill-Erkennungpi --no-skills
--prompt-template pathLädt eine Prompt-Vorlage, kann wiederholt verwendet werdenpi --prompt-template ./review.md
--no-prompt-templatesDeaktiviert die automatische Vorlagenerkennungpi --no-prompt-templates
--theme pathEin Theme laden, kann mehrfach verwendet werdenpi --theme ./my-theme.json
--no-themesAutomatische Theme-Erkennung deaktivierenpi --no-themes
-nc, --no-context-filesLaden von AGENTS.md/CLAUDE.md deaktivierenpi -nc

Weitere Optionen

Die folgenden Parameter überschreiben Verhaltensweisen wie System-Prompt, Projektvertrauen und Hilfeinformationen.

ParameterBeschreibungBeispiel
--system-prompt textErsetzt den Standard-System-Promptpi --system-prompt "Du bist ein Python-Experte"
--append-system-prompt TextAn den System-Prompt anhängenpi --append-system-prompt "Antworte auf Chinesisch"
--tui-modeSchnittstellenmodus, z. B. fullscreen; falls nicht angegeben, wird der normale Modus verwendetpi --tui-mode fullscreen
--use-themeLegt ein zu ladendes Theme fest; nur für den aktuellen Lauf wirksam, ändert die Konfiguration nichtpi --use-theme "dark-plus"
--verboseErzwingt die Anzeige detaillierter Startinformationenpi --verbose
-a, --approveProjektlokalen Dateien für diesen Lauf vertrauenpi -a
-na, --no-approveProjektlokalen Dateien für diesen Lauf nicht vertrauenpi -na
--Trennzeichen; der Inhalt danach wird unverändert an den Prompt übergebenpi -- @notes.md Fasse diese Notiz zusammen
-h, --helpHilfeinformationen anzeigenpi -h
-v, --versionVersionsnummer anzeigenpi -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.

UnterbefehlBeschreibung
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 listInstallierte Erweiterungspakete auflisten
pi updateAktualisiert pi selbst und Erweiterungspakete; unterstützt --self, --all, --models, --extensions, --extension <source>
pi configVerschiedene 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.

VariableZweckBeispiel
ANTHROPIC_API_KEYAlternative Methode zur Anthropic-Authentifizierung; wird verwendet, wenn man nicht über das /login-Abonnement angemeldet istsk-ant-api03-xxxx
HTTP_PROXY / HTTPS_PROXYEinen Proxyserver für API-Anfragen angebenhttp://127.0.0.1:7890
NO_PROXYProxy-Whitelist; übereinstimmende Hosts werden nicht über den Proxy geleitetlocalhost,127.0.0.1
COLORTERMEiner 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.trueColortruecolor

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