Fleet

Wszystkie Twoje komputery jako jedna flota. Zdalny dostęp z przeglądarki i MCP, przez które Claude steruje Twoimi maszynami: komendy, pliki, instalacje, ekran, mysz, klawiatura i zadania równoległe.

Zero zależności. Wystarczy Node.js ≥ 22.13 (wbudowany SQLite i WebSocket).

Chmura: https://fleet-cloud.onrender.com · npm: @xeniak/fleet

npx @xeniak/fleet up        # na każdej maszynie; kod dołączenia wygenerujesz w panelu

Hosting chmury

Chmura działa na Renderze (plan darmowy, Frankfurt). Dane (SQLite) są kopiowane do Supabase po każdej zmianie i odtwarzane przy starcie, więc nie potrzeba płatnego dysku. Zapis i odczyt idą przez funkcje RPC chronione sekretem serwera, a tabele są zamknięte przez RLS. Zmienne środowiskowe: FLEET_SUPABASE_URL, FLEET_SUPABASE_KEY (klucz publiczny), FLEET_SNAPSHOT_SECRET. Test: node test/persist-check.js.

Części

Related MCP server: SSH MCP Server

Szybki start (lokalnie)

node cli/fleet.js cloud --port 8080 --data ./data   # chmura: http://localhost:8080
node cli/fleet.js up                                # agent + lokalny dashboard

1. Załóż konto na http://localhost:8080/signup.

2. Maszyny → Dodaj maszynę daje kod. Wpisz go w lokalnym dashboardzie albo użyj node cli/fleet.js join KOD.

3. AI i MCP → Utwórz token, a potem node cli/fleet.js connect claude --token flt_....

4. W Claude Code: /fleet odpal testy 50/50 na pc i laptopie.

Funkcje panelu

• Maszyny na żywo: CPU, RAM, GPU/VRAM, dysk, wykresy

• Terminal, pliki (przeciągnij i upuść), ekran ze sterowaniem, procesy

• Uruchom na wielu: jedna komenda na wielu maszynach, wyniki obok siebie, {i}/{n} do dzielenia testów

• Paleta poleceń Ctrl K, skróty g m, g r, g a

• Publiczne podglądy portów, dziennik z eksportem CSV, aktywne sesje, lista startowa

• Autostart agenta: fleet service install albo przełącznik w lokalnym dashboardzie

Bezpieczeństwo

• Przycisk STOP AI blokuje AI na wszystkich maszynach.

• Polityka dla każdej kategorii (odczyt, komendy, zapis, instalacja, ekran, sterowanie, niebezpieczne): automatycznie, pytaj albo blokuj. Ustawiana dla konta i osobno dla maszyny. Domyślnie AI bez pytania tylko czyta i robi zrzuty ekranu.

• Blokady lokalne na samej maszynie, których chmura nie obejdzie.

• Logowanie dwuetapowe (TOTP) z kodem QR, 10 kodami zapasowymi jednorazowego użytku i blokadą ponownego użycia kodu. Własny generator QR i TOTP, bez zależności, zgodny bit w bit z biblioteką qrcode i z RFC 6238.

• Reset hasła e-mailem: własny klient SMTP (TLS/STARTTLS, AUTH PLAIN/LOGIN) skonfigurowany przez FLEET_SMTP_URL i FLEET_MAIL_FROM. Link działa 30 minut, tylko raz i po użyciu wylogowuje wszystkie sesje. Odpowiedź nie zdradza, czy konto istnieje. Bez SMTP maile trafiają do data/outbox.

• P2P w trzech poziomach:

  1. TCP bezpośrednio: kandydaci LAN, VPN (Tailscale, ZeroTier), globalne IPv6 i publiczny adres, sprawdzani równolegle.

  2. UDP z przebiciem NAT: STUN w chmurze (ten sam port co HTTP, po UDP), równoczesne pakiety z obu stron, niezawodny transfer z oknem 256 pakietów, SACK i szybką retransmisją.

  3. Przekaźnik strumieniowy w chmurze (jak DERP w Tailscale albo TURN w WebRTC) dla symetrycznych NAT: surowe bajty, bez zapisu w chmurze, jednorazowy adres.

  4. Awaryjnie kawałki po 4 MB przez kanał poleceń (np. starszy agent).

  Wszystko z jednorazowym tokenem i weryfikacją rozmiaru.

• PWA: panel da się zainstalować jak aplikację (manifest, service worker, ekran offline, skróty).

• Awaryjny reset hasła przez administratora chmury: fleet cloud reset-password <email> [--disable-2fa].

• Zgody czasowe („Zezwól na 15 min”) obejmują też oczekujące prośby, więc run_parallel nie pyta N razy. STOP AI cofa je wszystkie.

• Dziennik wszystkich akcji. Tokeny przechowywane jako SHA-256, hasła jako scrypt.

• CSP, X-Frame-Options, nosniff, HSTS na HTTPS, limity prób logowania i rejestracji, sprzątanie wygasłych sesji. Za reverse proxy ustaw FLEET_TRUST_PROXY=1, a FLEET_LOG=1 włącza logi żądań.

Test

npm test              # 13 grup testów sterowania (Windows, macOS, Linux) + 26 kroków end-to-end
npm run test:screen   # na żywo: zrzut, kursor 1 px w bok i z powrotem (potwierdzony przez system), Shift
npm run test:p2p-wsl  # dwa hosty (Windows + WSL2): TCP 12 MB i UDP przez zaporę 8 MB, zgodne SHA-256
npm run check:ops     # operacje agenta na bieżącym systemie
bash test/linux-screen.sh   # Linux z pulpitem, z xdotool i scrot rozpakowanymi do /tmp

Publikacja

npm pack     # sprawdzenie paczki (28 plików)
npm publish  # wymaga zalogowania do npm (npm login)

Struktura

cli/fleet.js          CLI (up, join, status, leave, cloud, connect claude)
agent/                agent, operacje, sterowanie ekranem, lokalny dashboard
cloud/                serwer HTTP/WS, hub, MCP, baza, strony www
shared/               WebSocket, informacje o systemie, katalog operacji
claude/commands/      komenda /fleet dla Claude Code

Co dalej

• Model AI rozłożony na maszyny floty (/fleet gpu, API zgodne z OpenAI i Anthropic)

• Potwierdzenia push na telefon, PWA

• Sterowanie ekranem na Wayland bez XWayland

• Instalatory .exe i .pkg