# CLI-viite

## Peruskäyttö

Suorita vain komento – argumentteja ei tarvita:

```bash
npx termbridge
```

Tämä käynnistää kaiken: paikallisen palvelimen, tmux-istunnon ja oletustunnelin Cloudflare.

Komennon `termbridge` suorittaminen ilman alikomentoa vastaa komentoa `termbridge start`.

Voit myös suorittaa `termbridge start`-komennon erikseen kaikkien valitsimien kanssa:

```bash
termbridge start --port 8080 --proxy 5173 --session dev --kill-on-exit --no-qr --tunnel cloudflare
```

## Valitsimet

| Valitsin | Kuvaus | Oletus |
|------|--------------|---------|
| `--port <port>` | Käytä tiettyä porttia satunnaisen sijaan | Satunnainen |
| `--proxy <port>` | Välitä paikallinen kehityspalvelin (ottaa käyttöön Terminal/Preview-näkymät) | - |
| `--session <name>` | Nimeä tmux-istuntosi | Luodaan automaattisesti |
| `--kill-on-exit` | Siivoa tmux-istunnot, kun Termbridge sulkeutuu | Ei käytössä |
| `--no-qr` | Älä tulosta QR-koodia (hyödyllinen skripteissä) | Ei käytössä |
| `--no-tunnel` | Poista tunneli käytöstä (edellyttää `--public-url`) | Ei käytössä |
| `--public-url <url>` | Julkinen URL, kun tunneli on poissa käytöstä | - |
| `--tunnel <provider>` | Tunnelipalveluntarjoaja (`cloudflare` tai `none`) | cloudflare |
| `--tunnel-token <token>` | Käytä nimetyn Cloudflare-tunnelin tunnusta (edellyttää `--port`) | - |
| `--tunnel-url <url>` | Nimetyn tunnelin julkinen URL (pakollinen valitsimen `--tunnel-token` kanssa) | - |
| `--backend <backend>` | Päätteen taustajärjestelmä (`tmux` tai `sandbox-daytona`) | tmux |
| `--sandbox-repo <url>` | Kloonattavan repon URL Daytona-hiekkalaatikkoon | - |
| `--sandbox-branch <branch>` | Hiekkalaatikossa käyttöön otettava haara | - |
| `--sandbox-path <path>` | Repon polku hiekkalaatikossa | Johdetaan repon nimestä |
| `--sandbox-name <name>` | Hiekkalaatikon nimi | Satunnainen `termbridge-<hex>` |
| `--sandbox-preview-port <port>` | Hiekkalaatikon esikatseluportti | - |
| `--sandbox-public` | Luo julkinen hiekkalaatikko | Ei käytössä (käytössä suorassa tilassa) |
| `--sandbox-direct` | Suorita palvelin Daytona-hiekkalaatikossa (ei tunnelia) | Ei käytössä |
| `--dev-proxy-url <url>` | Välitä esikatseluliikenne tähän URL-osoitteeseen kohteen `localhost:<proxy port>` sijaan (käytössä kehitysskripteissä) | - |
| `-h`, `--help` | Tulosta ohjeteksti | - |

Mikä tahansa muu valitsin aiheuttaa virheen `unknown option: <flag>`. Valitsinta `--version` ei ole.

Valitsin ohittaa vastaavan ympäristömuuttujan yhtä poikkeusta lukuun ottamatta: `TERMBRIDGE_TUNNEL` ohittaa tällä hetkellä arvot `--tunnel` ja `--no-tunnel` ([#5](https://github.com/inline0/termbridge/issues/5)).

> **Huomautus**
> Sisäänrakennetun `termbridge --help`-tulosteen luettelossa on edelleen valitsimia `--daytona-*` ja `--backend tmux | daytona`. Nämä nimet hylätään; käytä yllä olevan taulukon valitsimia `--sandbox-*` ja `--backend sandbox-daytona` ([#1](https://github.com/inline0/termbridge/issues/1)).

## Esimerkkejä

### Liity olemassa olevaan tmux-istuntoon

Jos tmux-istunto on jo käynnissä:

```bash
termbridge --session my-session
```

### Kiinteä portti ja mukautettu istunto

```bash
termbridge --port 8080 --session codex
```

### Siisti sulkeutuminen (ei jäännösistuntoja)

```bash
termbridge --kill-on-exit
```

### Skriptaus (ei QR-tulostetta)

```bash
termbridge --no-qr
```

### Välitä Vite-kehityspalvelin

```bash
# Start your Vite app first
cd my-app && npm run dev  # runs on port 5173

# Then start Termbridge with proxy
termbridge --proxy 5173
```

Vaihda Terminal- ja Preview-näkymien välillä Views-painikkeella. Preview lataa sovelluksesi välityspalvelimen kautta HMR-tuella.

### Nimetty Cloudflare-tunneli (tunnuspohjainen)

Jos sinulla on Cloudflare-tili ja haluat välttää trycloudflaren nopeusrajoitukset:

```bash
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com
```

### Poista tunneli käytöstä (käytä omaa julkista URL-osoitettasi)

```bash
termbridge --no-tunnel --public-url https://example.com
```

## Ympäristömuuttujat

Termbridge lukee ympäristömuuttujat komentotulkista ja `.env`-tiedostosta siinä hakemistossa, josta suoritat sen. Komentotulkissa jo asetetut muuttujat ohittavat `.env`-tiedoston arvot.

### Ydinasetukset

| Muuttuja | Kuvaus |
|----------|--------------|
| `TERMBRIDGE_SESSIONS=2` | Luo käynnistyksen yhteydessä useita tmux-istuntoja |
| `TERMBRIDGE_TMUX_CWD=/path` | Uusien tmux-istuntojen työhakemisto |
| `TERMBRIDGE_PUBLIC_URL=https://example.com` | Julkinen URL, kun tunneli on poissa käytöstä |
| `TERMBRIDGE_TUNNEL=none` | Poista tunneli käytöstä |
| `TERMBRIDGE_TUNNEL_TOKEN=<token>` | Nimetyn tunnelin tunnus (edellyttää `TERMBRIDGE_TUNNEL_URL`) |
| `TERMBRIDGE_TUNNEL_URL=https://term.example.com` | Nimetyn tunnelin julkinen URL |

### Lisäasetukset

Daytona-suoratila asettaa nämä arvot hiekkalaatikon sisällä suorittamalleen palvelimelle. Voit asettaa ne myös itse.

| Muuttuja | Kuvaus |
|----------|--------------|
| `TERMBRIDGE_HOST=0.0.0.0` | Osoite, johon palvelin sidotaan (oletus `127.0.0.1`). Tulostettu paikallinen URL näyttää aina `127.0.0.1`. |
| `TERMBRIDGE_COOKIE_SAMESITE=lax` | Istuntoevästeen `SameSite`-arvo: `lax`, `strict` tai `none` (oletus `Lax` tai `None` suorassa tilassa) |
| `TERMBRIDGE_SHARE_FILE=/path/share-url.txt` | Kirjoita jakamisen URL myös tähän tiedostoon |
| `TERMBRIDGE_HIDE_TERMINAL_SWITCHER=1` | Piilota päätteen valitsin kohdassa UI |
| `TERMBRIDGE_TMUX_PATH_PREFIX=/path/bin` | Lisää tämä etuliitteeksi arvoon `PATH` jokaisessa tmux-istunnossa, jonka Termbridge käynnistää tai johon se liittyy (syötetään istuntoon `export`-komentona) |

### Kehitys

| Muuttuja | Kuvaus |
|----------|--------------|
| `TERMBRIDGE_INSECURE_COOKIE=1` | Salli HTTP-evästeet (vain paikallisessa kehityksessä) |
| `TERMBRIDGE_PROXY_PORT=5173` | dev:beam:proxy-komentosarjan välityspalvelimen portti |
| `TERMBRIDGE_DEV_UI=http://127.0.0.1:5000` | Ohita Vite-kehityksen UI URL |
| `TERMBRIDGE_DEV_PORT=3000` | Ohita Termbridge-palvelimen portti kehityksessä (oletus `8787`) |
| `TERMBRIDGE_DEV_SESSION=codex` | tmux-istunnon nimi kohteelle `dev:beam` (oletus `codex`) |
| `TERMBRIDGE_SKIP_BUILD=1` | Ohita `dev:beam`-kohdan CLI-koontiversio |

### Hiekkalaatikko (Daytona)

| Muuttuja | Kuvaus |
|----------|--------------|
| `TERMBRIDGE_BACKEND=sandbox-daytona` | Käytä Daytona-hiekkalaatikkotaustajärjestelmää |
| `TERMBRIDGE_SANDBOX_DIRECT=true` | Suorita Termbridge hiekkalaatikossa |
| `TERMBRIDGE_SANDBOX_SERVER_PORT=8080` | Hiekkalaatikossa ajettavan palvelimen portti |
| `TERMBRIDGE_SANDBOX_AGENTS=claude-code,codex` | Asenna automaattisesti ja synkronoi agenttien todennustiedot |
| `TERMBRIDGE_SANDBOX_AGENT_ENV=...` | Ylimääräiset välitettävät ympäristömuuttujat |
| `TERMBRIDGE_SANDBOX_AGENT_AUTH_PATHS=...` | Synkronoitavat paikalliset todennustiedostot |

Katso täydelliset Daytona-määritykset [Daytona-oppaasta](https://termbridge.inline0.dev/fi/docs/sandboxes/daytona).

## Termbridge-ohjelman pysäyttäminen

Paina `Ctrl+C` päätteessä, jossa Termbridge on käynnissä. Tämä:

- Sulkee tunnelin (jos se on käytössä)
- Pysäyttää paikallisen palvelimen
- Pitää tmux-istunnot käynnissä (ellet käyttänyt `--kill-on-exit`-asetusta)

tmux-istuntosi säilyvät oletusarvoisesti, joten voit yhdistää niihin myöhemmin uudelleen.