Terminal CLI

Narzędzie wiersza poleceń speedwave pozwala na bezpośrednią pracę z Claude Code wewnątrz kontenerów projektu z poziomu preferowanego emulatora terminala. Oparte na wspólnej bibliotece speedwave-runtime, CLI zapewnia identyczne zachowanie modeli i taką samą orkiestrację kontenerów jak aplikacja Desktop.

Wymagania wstępne i instalacja CLI

Narzędzie CLI korzysta ze środowiska wirtualizacji i kontenerów skonfigurowanych przez aplikację Speedwave Desktop. Przed pierwszym użyciem CLI należy ukończyć wstępną konfigurację w aplikacji Desktop (Setup Wizard), która tworzy maszynę wirtualną, przygotowuje bazowe obrazy kontenerów i konfiguruje bezpieczne przechowywanie tokenów.

Plik binarny speedwave jest dołączony do aplikacji Desktop i automatycznie dodawany do systemowej ścieżki PATH (za pomocą dowiązania symbolicznego) podczas instalacji oraz kolejnych aktualizacji.

Polecenie speedwave --help działa niezależnie od stanu usług w tle. Pozostałe polecenia wymagają zainicjalizowanego środowiska Speedwave.

Uruchamianie sesji i wybór projektu

Po ukończeniu konfiguracji wykonanie polecenia speedwave uruchamia kontenery aktywnego projektu i otwiera interaktywną sesję Claude Code:

speedwave

Domyślnie CLI wybiera aktywny projekt zdefiniowany w pliku ~/.speedwave/config.json (zgodnie z wyborem w aplikacji Desktop). Aby uruchomić sesję w innym zarejestrowanym projekcie, użyj flagi --project:

speedwave --project moj-inny-projekt

Pełny wykaz poleceń, parametrów oraz zasad zarządzania wtyczkami znajdziesz w rozdziale Dokumentacja poleceń CLI.

Funkcje sesji terminalowej

Obsługa wklejania obrazów: W interaktywnych sesjach terminalowych (w tym speedwave oraz speedwave login) wklejanie danych graficznych ze schowka jest w pełni obsługiwane. Lokalny proces w tle wykrywa obrazy w schowku i zapisuje je w pliku <project_dir>/.speedwave/pastes/clip.png z uprawnieniami 0o600.
Przywracanie stanu terminala: Po zakończeniu sesji lub ewentualnej awarii kontenera CLI automatycznie zapobiega rozregulowaniu terminala, przywracając standardowe tryby klawiatury, myszy i wklejania tekstu.
Niezależność procesów: Działająca sesja CLI nie przerywa pracy po zamknięciu okna aplikacji Desktop. Usługi wymagające interfejsu graficznego (np. odświeżanie tokenów OAuth w tle czy worker mcp-os dla integracji systemowych) wstrzymują działanie do momentu ponownego uruchomienia aplikacji Desktop.

Wybór między CLI a aplikacją Desktop

Aplikacja Desktop oferuje graficzny przełącznik projektów, ikonę w zasobniku systemowym, automatyczne aktualizacje oraz wygodny widok czatu. Interfejs CLI jest zoptymalizowany pod kątem pracy w terminalu i skryptów automatyzacji. Oba narzędzia korzystają z tych samych kontenerów i jednolitych polityk bezpieczeństwa.