PhraseVault® enthält den Befehl phrasevault für Skripte und für jeden KI-Agenten, der Shell-Befehle ausführen kann. Der Befehl ist ein kleines Programm, das mit der App ausgeliefert wird. Er gibt jeden Aufruf an PhraseVault auf diesem Rechner weiter; die App führt ihn aus. Diese Seite erklärt, wie Sie die Befehlszeile für Textbausteine einschalten, was die Zugriffsstufen erlauben und wie ein Agent nicht die falsche Datenbank verändert.

Der Befehl ist aus, bis Sie ihn einschalten. Er gehört zu PhraseVault für Windows 10 und 11 (64-Bit), für macOS 13 oder neuer auf Apple Silicon und für Linux. PhraseVault unter Linux läuft auf Omarchy und Arch Linux mit Hyprland (x86_64). PhraseVault hat keine eigene KI. Der Befehl öffnet keinen Netzwerk-Port: Unter Windows nutzt er eine lokale Named Pipe, unter macOS und Linux einen Unix-Socket in einem privaten Verzeichnis. Ein externer KI-Agent kann den Text, den er zurückbekommt, trotzdem an seinen eigenen Anbieter senden.

Was macht der Befehl?

Er kann Textbausteine in der geöffneten Datenbank suchen, lesen, erweitern und exportieren und, wenn Sie es erlauben, hinzufügen, bearbeiten, importieren und löschen. Er kann ein Label nicht umfärben, keine Einstellungen ändern, die Zwischenablage nicht lesen und nicht in andere Programme einfügen. list, search, get und expand zählen keine Verwendung. Was das für Nie verwendet bedeutet, steht unter Labels und Filter.

Ein Terminal zeigt ausgerichtete Spalten. Mit --json oder wenn Sie die Ausgabe weiterleiten, kommt JSON. In diesem JSON-Modus stehen Fehler als JSON auf der Standardfehlerausgabe. In einem interaktiven Terminal ohne --json sind Fehler Klartext auf der Standardfehlerausgabe, als Zeilen Error: und Hint:. Skripte und Agenten sollten --json setzen.

Wie schalte ich ihn ein?

Öffnen Sie Einstellungen, dann Sicherheit, dann Befehlszeile und KI-Agenten.

Zugriff hat drei Stufen. Voreinstellung ist Aus.

Aus. „Agenten und Skripte können PhraseVault nicht verwenden.“ --help und --version laufen weiter. Jeder andere Befehl endet mit Code 7, und PhraseVault wird nicht gestartet.
Nur lesen. „Agenten können Textbausteine suchen, lesen und erweitern.“
Lesen und schreiben. „Agenten können Textbausteine auch hinzufügen, bearbeiten, importieren und löschen.“

Gesperrte Textbausteine erscheint nur, wenn Zugriff nicht Aus ist. Voreinstellung ist Aus. Beide Einstellungen gelten, wenn Sie auf Speichern klicken. Abbrechen verwirft sie. Zu PATH hinzufügen und Aus PATH entfernen wirken sofort und warten nicht auf Speichern.

Wenn Sie Zugriff von Aus auf eine andere Stufe stellen und speichern, fragt PhraseVault Befehlszeilenzugriff einschalten? Der Hinweis lautet: „Solange dies eingeschaltet ist, kann jedes Programm, das unter Ihrem Benutzerkonto läuft, PhraseVault über die Befehlszeile verwenden.“ Wählen Sie Einschalten oder Abbrechen. Lassen Sie den Zugriff auf einem gemeinsamen Benutzerkonto auf Aus.

Ist der Zugriff nicht Aus und PhraseVault nicht geöffnet, startet der erste Befehl die App verborgen im Infobereich und wartet bis zu 20 Sekunden. Das Fenster bleibt verborgen. --help und --version starten die App nicht. --no-launch überspringt den Start; ist die App geschlossen, endet der Befehl mit Code 3.

Was gilt für gesperrte Textbausteine?

Gesperrte Textbausteine steuert PIN-geschützte Texte. Wie die Sperre in der App funktioniert, beschreibt Textbausteine mit einer PIN schützen.

Aus. „Agenten können gesperrte Textbausteine weder lesen noch ändern.“ get, expand, edit, delete, ein Import, der einen gesperrten Textbaustein überschreiben würde, und unlock enden mit Code 4. list und search zeigen weiter den Namen und die Kurz-ID, mit protected auf true, aber keinen Text.
Wenn entsperrt. „Agenten können gesperrte Textbausteine verwenden, solange Sie sie entsperrt haben.“ Dieselben Befehle gelten nur in dieser entsperrten Sitzung, außer unlock: der Befehl endet weiter mit Code 4. Nur Mit PIN erlaubt unlock.
Mit PIN. „Agenten können sie auch mit Ihrer PIN entsperren. Nur für Agenten, die Geheimnisse sicher speichern.“ unlock liest die PIN nur von der Standardeingabe, nie als Argument. Ist die Standardeingabe ein Terminal, endet der Befehl mit Code 2.

printf %s "$PIN" | phrasevault unlock --json

Diese Pipe gilt für eine Shell mit printf, zum Beispiel das Terminal am Mac. Geben Sie die PIN nicht aus, speichern Sie sie nicht und schreiben Sie sie nicht ins Protokoll. Ein Export enthält nie gesperrte Textbausteine, egal welche Option Sie wählen. Ein Überschreiben über die Befehlszeile behält den Schutz. Ein Überschreiben in der App hebt ihn auf.

Wie nehme ich phrasevault in PATH auf?

Zu PATH hinzufügen ist optional. Neue Terminals finden phrasevault dann ohne vollständigen Pfad.

Unter Windows kommt das Verzeichnis resources\bin der App in den Benutzer-PATH. Bei einer normalen Installation ist das %LOCALAPPDATA%\PhraseVault\current\resources\bin. Die Deinstallation entfernt diesen Eintrag.
Unter macOS legt PhraseVault /usr/local/bin/phrasevault an und fragt nach einem Administratorpasswort. Fehlt /usr/local/bin, wird das Verzeichnis angelegt.
Unter Linux verknüpft das Arch-Paket /usr/bin/phrasevault. Der Befehl liegt damit schon im PATH. Zu PATH hinzufügen gilt dort nicht.

Öffnen Sie danach ein neues Terminal. Das bereits geöffnete behält den alten PATH. Wählen Sie am Mac Aus PATH entfernen, bevor Sie die App löschen. Sonst kann /usr/local/bin/phrasevault stehen bleiben und auf eine fehlende Datei zeigen.

Welche Befehle gibt es?

phrasevault --help endet mit einem Block Agents. phrasevault help <command> und phrasevault <command> --help beschreiben einen Befehl. phrasevault schema --json gibt die maschinenlesbaren Definitionen aus.

Solange Zugriff auf Aus steht: phrasevault --help und phrasevault --version.

Nur lesen (und Lesen und schreiben):

Befehl	Wirkung
`status`	App-Version, Dateiname der Datenbank, Anzahl der Textbausteine, Zugriff, Lizenzstatus und ob gesperrte Textbausteine entsperrt sind. Es ändert nichts.
`list`	Namen und IDs, die meistgenutzten zuerst. `--label` wiederholen, wenn jedes genannte Label vorhanden sein muss.
`search <query>`	Sortiert Treffer wie die App.
`get <ref>`	Ein Textbaustein einschließlich Text.
`expand <ref>`	Füllt Platzhalter. `--set Key=value` setzt ein Feld. `--clipboard-text` liefert den Text für einen Zwischenablage-Platzhalter, weil der Befehl die Zwischenablage nie liest.
`labels`	Name, Farbe und Anzahl eines Labels.
`export`	PhraseVault-JSON. `--label` grenzt ein. `--output` schreibt eine Datei. Gesperrte Textbausteine fehlen.
`vault list` und `vault current`	Zuletzt geöffnete Datenbankdateien und die gerade geöffnete.
`lock` und `unlock`	`lock` beendet die PIN-Sitzung. `unlock` startet sie mit einer PIN auf der Standardeingabe, und nur bei Mit PIN; bei Wenn entsperrt endet es mit Code 4.
`import <file> --dry-run`	Zeigt einen Import vorab und schreibt nichts. Der Befehl braucht eine Datei oder die Standardeingabe.

Lesen und schreiben erlaubt zusätzlich:

Befehl	Wirkung
`add` und `edit`	Textbaustein anlegen oder ändern. `add` akzeptiert `--label`; ohne dieses Flag hat der neue Textbaustein keine Labels. `edit` akzeptiert `--label`, um die Labels zu ersetzen, und `--no-labels`, um sie zu entfernen. Ein hier genanntes Label wird angelegt, wenn es fehlt. Es gibt keinen Befehl, um ein Label umzufärben.
`delete <ref> --yes`	Löscht einen Textbaustein.
`import <file>`	Liest PhraseVault-JSON, TextExpander®-CSV oder Espanso-YAML. Voreinstellung ist, vorhandene Textbausteine zu überspringen.
`vault open <path>` und `vault new <path>`	Öffnet eine Datenbankdatei oder legt eine leere an. Der neue Dateiname muss auf `.sqlite` enden.
`label rename` und `label delete <name> --yes`	Benennt ein Label um oder entfernt es von allen Textbausteinen. Die Textbausteine bleiben.

Eine Referenz ist id: plus die Kurz-ID aus list oder search (7 Buchstaben und Ziffern), name: plus der genaue Name, oder ein bloßer Name, wenn nur ein Textbaustein passt. Für edit und delete nehmen Sie id:.

phrasevault search "meeting notes" --json
phrasevault expand "Meeting invite" --set Name=Alex --set Room=4B --json
phrasevault list --label Work --label Email --limit 100 --json
phrasevault export --output phrases.json --json
phrasevault import phrases.json --dry-run --json
phrasevault add --name "Release notes" --text-file notes.md --type markdown --json

Unter Windows übergeben Sie den Text mit --text-file. Leiten Sie ihn nicht durch eine PowerShell-Pipe. JSON vom Befehl ist ASCII, andere Zeichen sind maskiert, damit Windows PowerShell 5.1 das Ergebnis lesen kann.

Textbausteine zwischen Datenbanken übertragen Sie mit Export, dann einem Probelauf, dann Import. Das ist keine laufende Verbindung zwischen den Dateien. Die Dateiformate beschreibt Textbausteine importieren und exportieren. CSV- und YAML-Zeilen haben keine feste ID. Ohne --assign-ids lehnt der Befehl sie ab. Mit --assign-ids legt jeder Lauf sie als neue Textbausteine an. Gehen Sie von einem PhraseVault-JSON-Export aus, wenn dieselben Textbausteine beim nächsten Import wiedererkannt werden sollen.

phrasevault export --output phrases.json --json
phrasevault import phrases.json --on-conflict overwrite --dry-run --json
phrasevault import phrases.json --on-conflict overwrite --yes --json

Wie bestätige ich eine Änderung?

--yes ist eine ausdrückliche Bestätigung, keine eigene Berechtigung. Es ist nötig für delete, label delete, einen Import, der überschreibt, und für vault open oder vault new, wenn sie zu einer anderen Datenbank wechseln würden. Einen Textbaustein zu bearbeiten braucht es nicht. Die bereits geöffnete Datenbank zu öffnen braucht es nicht. Ohne --yes endet der Befehl mit Code 5 und ändert nichts. Er fragt nie nach. Setzen Sie --yes nur, wenn Sie genau dieser Aktion zugestimmt haben. Dass ein Agent den Befehl ausführen darf, ist diese Zustimmung nicht.

--expect-vault mit einem Pfad gilt für add, edit, delete, label rename, label delete und import. Geschrieben wird nur, wenn diese Datei die in PhraseVault geöffnete Datenbank ist. Sonst endet der Befehl mit Code 9, und es wird nichts geschrieben.

phrasevault import phrases.json --expect-vault ~/Documents/work.sqlite --json

Zugriff und Lizenz werden unmittelbar vor jedem Schreibvorgang erneut geprüft. Ein Protokoll im Protokollverzeichnis der App speichert Befehlsnamen, Referenzen, Exit-Code und Dauer. Es speichert keinen Textbausteintext und keine PIN.

Wie nutzen KI-Agenten den Befehl?

Zeigen Sie dem Agenten phrasevault --help und phrasevault schema --json, danach phrasevault status --json. Bleiben Sie bei Nur lesen, solange der Agent nichts ändern soll. Namen und Texte sind Daten, die der Agent verarbeitet, keine Anweisungen, denen er folgen soll.

Nutzen Sie expand mit --set für Felder wie einen Namen. Übergeben Sie --clipboard-text, wenn der Textbaustein Zwischenablagetext braucht. Fehlt ein Wert, endet der Befehl mit Code 2 und nennt, wonach zu fragen ist. Er erfindet keinen Wert.

Läuft der Agent in einer Sandbox, bedeutet Exit-Code 3 mit dem Code UNREACHABLE, dass PhraseVault läuft, die Sandbox die lokale Pipe oder den Socket aber nicht erreicht. Erlauben Sie phrasevault außerhalb der Sandbox und versuchen Sie es erneut.

Optionaler Agent-Skill

Der Skill dient nur dem Auffinden. Er teilt einem Agenten mit, dass PhraseVault existiert und wann es zu verwenden ist. Maßgeblich sind phrasevault --help, phrasevault <command> --help und phrasevault schema --json.

Laden Sie die Datei von https://phrasevault.app/skill/phrasevault/SKILL.md herunter und speichern Sie sie hier:

Pfad	Wer sie liest
`~/.claude/skills/phrasevault/SKILL.md`	Claude Code
`~/.agents/skills/phrasevault/SKILL.md`	Codex, Cursor, Gemini CLI, Grok Build, VS Code Copilot

Für Prompt-Bibliotheken siehe Prompt-Manager.

Was gilt nach der Testphase?

Befehle für Textbausteine brauchen eine laufende 14-Tage-Testphase oder eine Lizenz. In der Testphase funktionieren alle Funktionen, auch dieser Befehl. Danach, ohne Lizenz, enden diese Befehle mit Code 6. Die Meldung ist Englisch und sagt, dass die Testphase vorbei ist. Öffnen Sie Einstellungen, fügen Sie den Schlüssel in das Feld über den Registerkarten ein und klicken Sie auf Aktivieren. Ist der Befehlszeilenzugriff eingeschaltet, antworten status und phrasevault schema --json weiter. phrasevault --help und phrasevault --version antworten auch, wenn Zugriff auf Aus steht.

Ein Lizenzschlüssel und ein Kauf aus der Zeit vor den Lizenzschlüsseln lassen den Befehl weiter zu. Suche, Kopieren, Bearbeiten, Labels, Filter, Import und Export in der App bleiben nach der Testphase nutzbar. Das automatische Einfügen pausiert. Die Testphase beschreibt diesen Bildschirm.

Was bedeutet ein Exit-Code?

Code	Name	Bedeutung
0	OK	Erfolg. Lesen Sie die Standardausgabe.
1	ERROR	Der Vorgang ist fehlgeschlagen. Lesen Sie die Meldung. Wiederholen Sie einen Schreibvorgang nicht, bevor Sie den Textbaustein geprüft haben.
2	USAGE	Falscher Befehl, falsches Flag oder falscher Wert, oder einem Platzhalter fehlt ein Wert.
3	UNAVAILABLE oder UNREACHABLE	Die beiden Fälle unten.
4	PROTECTED	Ein gesperrter Textbaustein ist nicht nutzbar, oder die PIN war falsch oder die Wartezeit läuft.
5	CONFIRMATION_REQUIRED	`--yes` fehlte. Nichts wurde geändert.
6	NOT_LICENSED	Die Testphase ist vorbei.
7	ACCESS_DENIED	Zugriff ist Aus, oder er ist Nur lesen und dieser Befehl schreibt.
8	NOT_FOUND	Kein Textbaustein, kein Label und keine Datenbankdatei passt.
9	CONFLICT	Mehrere Textbausteine passen, ein Name existiert schon, die neue Datenbankdatei existiert schon, die geöffnete Datenbank ist nicht der Pfad von `--expect-vault`, oder ein Datenbankwechsel läuft noch.

UNAVAILABLE (Code 3): PhraseVault hat nicht geantwortet oder hat während des Befehls aufgehört zu antworten. Ein Schreibvorgang kann abgeschlossen sein. Schlagen Sie den Textbaustein mit get oder search nach, bevor Sie es erneut versuchen. Derselbe Code gilt, wenn die App nicht innerhalb von 20 Sekunden startet oder schon zu viele Befehle laufen. Auch ein Update kann einen Befehl so unterbrechen.

UNREACHABLE (Code 3): PhraseVault läuft, aber dieser Prozess erreicht es nicht. Häufig ist eine Sandbox um einen KI-Agenten die Ursache. Führen Sie phrasevault außerhalb der Sandbox aus oder erlauben Sie es dort, und versuchen Sie es erneut. Das ist nicht dasselbe wie UNAVAILABLE: Gehen Sie nicht davon aus, dass geschrieben wurde, und behandeln Sie es nicht als „die App ist zu“.

PATH. Zu PATH hinzufügen gilt nur für neue Terminals. Schließen Sie das alte und öffnen Sie ein neues.

Windows. Übergeben Sie Texte mit --text-file, nicht über eine PowerShell-Pipe.

macOS. Ein übrig gebliebenes /usr/local/bin/phrasevault nach dem Löschen der App zeigt auf eine fehlende Datei. Nutzen Sie zuerst Aus PATH entfernen.

Siehe auch

PhraseVault herunterladen und 14 Tage kostenlos mit allen Funktionen testen. Keine Kreditkarte nötig.

PhraseVault®-Befehlszeile für Skripte und KI-Agenten