Instalacja
Na Macu
Dział zatytułowany „Na Macu”Aplikacja couchterm na Maca prowadzi przez instalację w kreatorze. Każdy krok pyta, zanim cokolwiek zmieni poza katalogiem aplikacji.
Instalator po kolei:
- Sprawdza narzędzia: Node 20 lub nowszy i tmux. Brakujące proponuje doinstalować przez Homebrew.
- Instaluje zależności aplikacji.
- Tworzy ustawienia. Serwer słucha tylko na tym komputerze (
127.0.0.1). Istniejących ustawień nie nadpisuje. - Prosi o hasło, co najmniej 12 znaków. Na dysku zostaje tylko jego skrót.
- Dokłada dyktowanie (Whisper, około 1,6 GB) i czytanie na głos. Ten krok możesz pominąć.
- Włącza autostart, żeby couchterm działał po restarcie komputera.
- Udostępnia couchterm Twoim urządzeniom w Tailscale.
- Na końcu uruchamia sprawdzenie.
Po instalacji aplikacja pokazuje listę dodatków z przyciskiem przy każdym brakującym.
Na Linuksie
Dział zatytułowany „Na Linuksie”Pobrany plik AppImage przy pierwszym uruchomieniu zapisuje aplikację w katalogu domowym i dodaje ją do menu aplikacji. Później uruchamiaj couchterm z tego menu. Starszy plik AppImage nie zastąpi nowszej zainstalowanej wersji: pokaże komunikat i zamknie okno. Jeśli trwa już instalacja, komunikat podaje ścieżkę jej zamka. Zamek starszy niż 30 minut zostaje odzyskany przy kolejnej próbie, także po ponownym uruchomieniu komputera.
Jeśli druga instalacja właśnie trwa, zobaczysz komunikat. Poczekaj na jej zakończenie i spróbuj ponownie.
Instalator można też uruchomić w terminalu:
scripts/install.shRóżnice względem Maca:
- programy instaluje z
aptprzezsudo. Gdy Node zaptjest za stary, bierze Node 22 z oficjalnego repozytorium NodeSource; - dyktowanie liczy się na procesorze. Whisper jest budowany ze źródeł do
~/.local/bin; - czytanie na głos działa głosami Piper albo głosem telefonu;
- autostart to usługa użytkownika
systemd(systemctl --user status couchterm). Działa też bez zalogowania, więc nadaje się na serwer w szafie.
Restart usługi zachowuje workspace’y, terminale i pracujących w nich agentów. Ponowne uruchomienie kroku autostart i zatwierdzenie usługi zapisuje jej aktualne ustawienia również w istniejącej instalacji.
Dodatki później
Dział zatytułowany „Dodatki później”Każdy krok uruchomisz osobno, bez przechodzenia całej instalacji:
scripts/install.sh --step=whisperDostępne kroki: core, whisper, piper, hooks, cmux, autostart, tailscale-share, tailscale-public. Kilka naraz rozdzielasz przecinkiem.