Instalacja

Zainstaluj CLI przez npm, sprawdź działanie i aktualizuj pakiet.

Instalacja przez npm

Potrzebujesz Node.js 20.5.0 lub nowszego oraz npm 9.7.1 lub nowszego. Otwórz terminal na komputerze lub serwerze, na którym działa agent:

npm install --global @palladin/cli

Instalacja udostępnia polecenie palladin. Pakiet uruchamia natywny runtime dopasowany do wersji CLI i systemu operacyjnego.

Sprawdzenie instalacji

palladin --version
palladin doctor

--version pokazuje wersję CLI. doctor sprawdza runtime i dostęp do systemowego magazynu kluczy. Nie rejestruje agenta ani nie przyznaje dostępu do sejfu.

Jeśli terminal nie rozpoznaje palladin, otwórz nową sesję i sprawdź, czy katalog globalnych programów npm znajduje się w PATH. Więcej w rozwiązywaniu problemów.

System i magazyn kluczy

Wydanie CLI 0.0.9 udostępnia natywny runtime dla macOS Apple Silicon i Linux. Windows oraz macOS Intel nie są dostępne w tym wydaniu. Wymaga dostępu do systemowego magazynu kluczy. Nie uruchamiaj go z sudo tylko po to, by ominąć błąd uprawnień: agent powinien działać jako docelowy użytkownik systemu.

Hardened a Convenience

Hardened — zalecany tryb ochrony Palladina. Wykorzystuje mechanizmy systemowe ograniczające dostęp innych procesów do kluczy i poświadczeń agenta. Nie chroni jednak przed przejęciem całego systemu ani przed programem, któremu udzielisz dostępu do sekretu.

Convenience — tryb o ograniczonej izolacji. Używa systemowego magazynu kluczy i wymaga zaufania do innych procesów działających na tym samym koncie systemowym. Złośliwy proces może uzyskać dostęp do poświadczeń lub ich użycia. Na Linuxie Secret Service nie rozróżnia procesów działających z tym samym identyfikatorem użytkownika.

Nazwy Hardened i Convenience określają poziomy ochrony Palladina, nie certyfikację ani branżowy standard. Apple Hardened Runtime to osobny mechanizm macOS; sam nie opisuje całej ochrony kluczy w Palladin.

Platforma	Instalacja i ochrona
macOS Apple Silicon	Oficjalny pakiet npm zawiera podpisany runtime Hardened. Odczyt poświadczenia organizacji wymaga obecności użytkownika.
Linux	W wydaniu CLI 0.0.9 instalacja npm korzysta z Convenience i Secret Service. Broker Hardened nie jest częścią tego wydania.
Windows / macOS Intel	Brak publicznego pakietu runtime w wydaniu 0.0.9.

Sprawdź wynik palladin doctor przed podłączeniem agenta. Jeśli Twoje środowisko wymaga Hardened, nie zastępuj go Convenience. Samo powodzenie npm install nie potwierdza poziomu ochrony.

Aktualizacja

npm install --global @palladin/cli@latest
palladin --version
palladin doctor

Zachowaj istniejące profile. Jeśli korzystasz z MCP, uruchom ponownie jego serwer po aktualizacji.

Następny krok

Podłącz agenta do swojego panelu. Zalecamy korzystanie z CLI. MCP jest opcją dla aplikacji, które wymagają tego interfejsu.