Polecenia CLI

Poniższy rozdział stanowi kompletny wykaz poleceń i flag wiersza poleceń speedwave. Przegląd możliwości interfejsu terminalowego znajdziesz na stronie Wiersz poleceń CLI.

Wykaz poleceń

Polecenie	Przeznaczenie
`speedwave [--project <nazwa>]`	Inicjalizacja kontenerów i uruchomienie interaktywnej sesji Claude.
`speedwave init [nazwa]`	Rejestracja bieżącego katalogu roboczego jako projektu.
`speedwave login [--project <nazwa>]`	Uwierzytelnienie w usłudze Anthropic OAuth.
`speedwave logout [--project <nazwa>]`	Usunięcie poświadczeń sesji Claude w danym projekcie.
`speedwave check`	Weryfikacja wymagań wstępnych oraz audyt reguł SecurityCheck.
`speedwave update [--project <nazwa>]`	Przebudowa zmienionych obrazów i odtworzenie kontenerów.
`speedwave self-update`	Aktualizacja pliku binarnego CLI do najnowszego wydania.
`speedwave plugin install <ścieżka.zip>`	Weryfikacja i instalacja podpisanej wtyczki.
`speedwave plugin list`	Wyświetlenie listy wtyczek wraz ze statusem weryfikacji.
`speedwave plugin remove <slug>`	Usunięcie wtyczki oraz skompilowanych obrazów kontenerów.
`speedwave plugin enable <id> --project <nazwa>`	Aktywacja zweryfikowanej wtyczki w wybranym projekcie.
`speedwave plugin disable <id> --project <nazwa>`	Dezaktywacja wtyczki w wybranym projekcie.
`speedwave --help` / `-h` / `help`	Wyświetlenie pomocy i zakończenie działania.

Nieobsługiwane polecenia zwracają komunikat unknown command: '<x>'. Run 'speedwave --help' for usage. Błędne parametry końcowe zgłaszają unexpected argument: '<x>'. Pomoc podręczna działa bez konieczności uruchamiania środowiska wirtualizacji.

Kolejność rozwiązywania aktywnego projektu

Polecenia akceptujące parametr --project <nazwa> ustalają docelowy obszar roboczy według następującego porządku:

Wartość przekazana bezpośrednio w argumencie --project <nazwa> lub --project=<nazwa>.
Aktywny projekt zadeklarowany w polu active_project w pliku ~/.speedwave/config.json.
Pierwszy zarejestrowany projekt w konfiguracji (jeśli żaden nie został oznaczony jako aktywny).

W przypadku braku możliwości dopasowania projektu polecenie zgłasza błąd No project configured.

Katalog roboczy nie determinuje aktywnego projektu (wyjątkiem jest speedwave init, który rejestruje bieżący folder).

Uruchomienie speedwave bez argumentów automatycznie weryfikuje obecność wymaganych warstw obrazów kontenerowych, kompilując brakujące elementy przed startem sesji. Następnie synchronizuje skille i polecenia Claude oraz czyści przestarzałe tagi obrazów.

Rejestracja projektu

Zarejestruj katalog roboczy za pomocą speedwave init. W przypadku braku nazwy Speedwave utworzy identyfikator na podstawie nazwy folderu:

speedwave init          # rejestracja pod nazwą katalogu
speedwave init moj-app  # rejestracja pod wskazaną nazwą

Nazwa projektu może mieć maksymalnie 63 znaki, musi zaczynać się od znaku alfanumerycznego i zawierać wyłącznie małe litery (a-z), cyfry (0-9), kropki (.), podkreślenia (_) oraz łączniki (-). Jeśli katalog jest już zarejestrowany, polecenie wyświetla istniejącą nazwę.

Zarządzanie uwierzytelnianiem

Polecenie speedwave login uruchamia kontenery i wykonuje procedurę claude auth login --claudeai wewnątrz kontenera. Logowanie OAuth w przeglądarce zapisuje dane autoryzacyjne w wolumenie claude-home.

Przed rozpoczęciem logowania Speedwave ustawia Anthropic jako aktywnego dostawcę w projekcie, bezpiecznie zachowując dotychczasową konfigurację modeli własnych.

speedwave logout usuwa pliki poświadczeń (.claude/.credentials.json oraz .claude.json) z wolumenu projektu. Poświadczenia wtyczek należy usuwać z poziomu aplikacji Desktop (zobacz Używanie wtyczek).

Diagnostyka i audyty bezpieczeństwa

Polecenie speedwave check uruchamia walidację środowiska hosta oraz audyt SecurityCheck, wyświetlając status OK/FAIL dla każdej reguły i kończąc działanie kodem 0 w przypadku sukcesu lub 1 w razie wykrycia problemów.

Zaktualizuj kontenery

Polecenie speedwave update przebudowuje zmienione obrazy kontenerów i odtwarza topologię środowiska roboczego, raportując wynik komunikatem Updated N containers (M images rebuilt).

Przed rozpoczęciem aktualizacji tworzona jest migawka konfiguracji w ~/.speedwave/snapshots/<project>/snapshot.json. W przypadku niepowodzenia aktualizacji Speedwave automatycznie przywraca poprzedni stan kontenerów.

Aktualizacja pliku binarnego CLI

speedwave self-update pobiera najnowszy plik wykonywalny z GitHub Releases, podmienia binarium i przebudowuje obrazy kontenerów.

W przypadku uruchomienia z wnętrza paczki .app polecenie sugeruje wykonanie aktualizacji przez aplikację Desktop. Sprawdzanie dostępności aktualizacji odbywa się w tle maksymalnie raz na dobę.

Zarządzanie wtyczkami z poziomu CLI

speedwave plugin install ./acme-plugin.zip
speedwave plugin list
speedwave plugin remove <slug>
speedwave plugin enable <service_id> --project acme
speedwave plugin disable <service_id> --project acme

install: Weryfikuje podpis Ed25519, rozpakowuje pliki do ~/.speedwave/plugins/<slug>/ i kompiluje obraz kontenera.
list: Wyświetla zainstalowane wtyczki ze znacznikami [verified] lub [UNVERIFIED: <powód>].
remove: Usuwa pakiet wtyczki i katalogi stanu.
enable: Włącza zweryfikowaną wtyczkę w wybranym projekcie.
disable: Wyłącza wtyczkę w projekcie (działa także dla wtyczek niezweryfikowanych).