# Pierwsze kroki

## Instalacja wymaganych narzędzi

Aby skonfigurować domyślny tunel lokalny, zainstaluj na komputerze te narzędzia:

### Node.js 20+

Pobierz z [nodejs.org](https://nodejs.org) lub użyj menedżera pakietów.

```bash
# Check if installed
node --version
```

### tmux

Multiplekser terminala, który obsługuje sesje Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Tworzy bezpieczny tunel do Twojego terminala (nie jest potrzebne w trybie bezpośrednim sandboxa).

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[Pobierz cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Uruchom Termbridge

```bash
npx termbridge
```

Zobaczysz podobne dane wyjściowe:

```
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘
```

> **Uwaga**
> `trycloudflare.com` URL to szybki tunel bez konta. Jeśli często korzystasz z Termbridge,
> skonfiguruj token nazwanego tunelu Cloudflare, aby uniknąć limitów szybkości.


## Połącz się z telefonu

1. Otwórz aparat w telefonie
2. Skieruj go na kod QR
3. Kliknij wyświetlony link
4. Terminal otworzy się w przeglądarce

To wszystko — połączenie gotowe!

## Co się właśnie stało?

1. Termbridge uruchomił lokalny serwer na Twoim komputerze
2. Utworzył sesję tmux dla Twojego terminala
3. Cloudflare utworzył bezpieczny tunel (`trycloudflare.com` URL)
4. Kod QR zawiera jednorazowy token zapewniający bezpieczny dostęp. Działa tylko raz i wygasa 90 sekund po uruchomieniu, więc zeskanuj go szybko; jeśli stracił ważność, uruchom ponownie Termbridge, aby wygenerować nowy
5. Po zeskanowaniu otrzymasz plik cookie sesji i połączysz się

## Wypróbuj

Po połączeniu wypróbuj kilka poleceń:

```bash
# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool
```

Terminal obsługuje pełną paletę kolorów, TUI i wszystkie standardowe klawisze.

## Nie zamykaj programu

Termbridge musi działać, aby połączenie było aktywne. Gdy skończysz:

- Naciśnij `Ctrl+C` w terminalu, w którym działa Termbridge
- Tunel zostanie zamknięty, a połączenie zakończone
- Twoja sesja tmux pozostanie aktywna (chyba że użyto `--kill-on-exit`)

## Działanie pierwszej sesji

- Termbridge tworzy sesję tmux (domyślna nazwa jest wyznaczana na podstawie portu)
- Pierwszy terminal na liście jest wczytywany automatycznie
- Przy uruchamianiu możesz utworzyć wiele sesji, ustawiając `TERMBRIDGE_SESSIONS=2`

## Korzystanie z istniejącej sesji tmux

Jeśli przekażesz `--session <name>`, a ta sesja już istnieje, Termbridge dołączy do niej zamiast tworzyć nową. Przydaje się to do monitorowania długo działających procesów, które zostały już uruchomione.

## Następne kroki

### [Sterowanie na urządzeniach mobilnych](https://termbridge.inline0.dev/pl/docs/usage/mobile-controls)

Wskazówki dotyczące korzystania z Termbridge na telefonach i tabletach

### [Wiele terminali](https://termbridge.inline0.dev/pl/docs/usage/multiple-terminals)

Uruchamiaj wiele sesji i przełączaj się między nimi

### [Podgląd serwera deweloperskiego](https://termbridge.inline0.dev/pl/docs/usage/dev-server-preview)

Wyświetl podgląd aplikacji Vite obok terminala

### [CLI Dokumentacja](https://termbridge.inline0.dev/pl/docs/cli)

Zobacz wszystkie dostępne flagi i opcje