# Referencja CLI

> Palladin documentation · 1.0 · PL · 2026-10-25


Inject do przeglądarki działa obecnie tylko na macOS, przez rozszerzenie Palladin. Dostępność CLI na Linux nie oznacza obsługi Inject.

## Składnia

```sh
palladin [--id <profile>] <command> [options]
palladin <command> --help
```

`--id` wybiera profil dla danego wywołania. W automatyzacji podawaj go jawnie. Nawiasy ostrokątne oznaczają wartości do zastąpienia; nie są częścią polecenia.

## Konfiguracja i diagnostyka

| Komenda | Działanie |
| --- | --- |
| `--version` | Wersja uruchomionego CLI. |
| `doctor` | Diagnostyka runtime bez otwarcia tożsamości. |
| `init` | Utworzenie domyślnego profilu, jeśli nie istnieje. |
| `pair-agent --host <origin> --setup-descriptor '<descriptor>'` | Połączenie przez zatwierdzenie w przeglądarce. |
| `connect --host <origin>` | Alternatywne połączenie z maskowanym promptem API key. |
| `status` | Status rejestracji wybranego Agenta. |
| `pair` | Parowanie aktywnych sejfów i przypięcie potwierdzonych kluczy podpisujących. |
| `agents list` | Lista lokalnych aliasów. |
| `agents create <name>` | Nowa, odrębna tożsamość. |
| `agents rename <old> <new>` | Zmiana aliasu bez przenoszenia sekretów. |
| `mcp serve` | Serwer MCP przez stdio. |

`connect --api-key-stdin` przyjmuje klucz ze standardowego wejścia. Nie używaj jawnego klucza w poleceniu shell, historii ani rozmowie. Zalecamy parowanie przez panel web.

## Wyszukiwanie

```sh
palladin --id <profile> search '<query>' --json --page-size 10
```

Fraza ma co najmniej dwa znaki po usunięciu skrajnych spacji. `--cursor` kontynuuje wynik poprzedniej strony; `--page-size` przyjmuje 1–100. Widoczność metadanych nie nadaje prawa do odczytu sekretu.

## Użycie danych

| Komenda | Najważniejsze parametry |
| --- | --- |
| `get <vault-id> <entry-id>` | `--reason`, `--field` lub `--field-id`; zwraca dane w jawnej postaci. |
| `exec <vault-id> <entry-id> -- <program> <args>` | `--reason`, powtarzalne `--env NAME=FIELD`; nie interpoluj sekretów do argumentów. |
| `exec <vault-id> <script-entry-id>` | Wykonanie Script; `--parameters-stdin` dla obiektu parametrów. |
| `inject <vault-id> <entry-id>` | `--provider extension`, `--target-tab-id`, `--page-url`. |
| `report-stale <vault-id> <entry-id>` | `--code login_rejected`, `auth_failed` lub `manual`. |

Dla `get`, `exec` i `inject`: `--wait 2m` ogranicza oczekiwanie na zgodę (maksymalnie 5 minut), `--no-wait` wraca od razu, `--poll-interval 10s` ustawia odstęp między sprawdzeniami statusu, `--progress plain|json|none` wybiera komunikaty postępu. Inject odrzuca CDP, własne selektory pól, `--no-submit`, `--fill-only`, `--field`, `--field-id` i `--verbose`. Używaj kanału rozszerzenia.

## Przeglądarka

`browser status` sprawdza kanał. `browser install` wymaga obsługiwanego pakietu rozszerzenia i kanału integracji. Tab ID i URL służą do wyboru celu; runtime i rozszerzenie nadal niezależnie sprawdzają pochodzenie i dokument.

Podawaj `--target-tab-id` razem z `--page-url` albo pomiń oba. Eksperymentalne formularze na stronach wymagają jawnego celu.

## Operacje usuwające

`disconnect --purge --confirm` usuwa wybraną lokalną tożsamość. `purge --confirm` usuwa wszystkie lokalne profile. Nie są to kroki diagnostyczne; wymagają świadomej decyzji użytkownika. Usunięcie lokalnej tożsamości nie zastępuje cofnięcia dostępu po stronie organizacji.