
# 여러 터미널

Termbridge은 여러 터미널 세션을 동시에 실행할 수 있습니다. 한 서버에서 여러 tmux 세션을 호스팅하고, UI을 사용해 세션 간에 전환할 수 있습니다.

## 작동 방식

- Termbridge은 현재 실행에서 생성했거나 연결한 세션을 추적합니다
- 터미널 전환기에 사용 가능한 모든 세션이 표시됩니다
- 다시 연결하지 않아도 즉시 전환됩니다

## 여러 세션 만들기

### 시작할 때

`TERMBRIDGE_SESSIONS` 환경 변수를 사용하세요:

```bash
TERMBRIDGE_SESSIONS=3 npx termbridge
```

세션 세 개가 생성됩니다: `<base>`, `<base>-2`, `<base>-3`.

### 개발 중

바로 가기 스크립트를 사용하세요:

```bash
bun run dev:beam:multi
```

### Termbridge 실행 중

UI은 터미널 간 전환만 지원하며 세션 생성 기능은 없습니다. 터미널을 더 추가하려면 더 높은 `TERMBRIDGE_SESSIONS`로 Termbridge을 다시 시작하거나, tmux 세션 안에서 별도의 창을 여세요(`Ctrl+B` 다음 `c`).

## 터미널 전환

1. 하단 바에서 터미널 아이콘을 탭합니다
2. 사용 가능한 세션 목록이 표시됩니다
3. 전환할 세션을 탭합니다

전환은 즉시 이루어지며 이전 세션은 백그라운드에서 계속 실행됩니다.

## 사용 사례

### 빌드 및 로그

한 터미널에서 빌드를 실행하고 다른 터미널에서 로그를 확인하세요:

```bash
# Terminal 1: Build
npm run build

# Terminal 2: Logs
tail -f logs/app.log
```

작업하던 위치를 잃지 않고 두 터미널을 전환할 수 있습니다.

### 서버 및 클라이언트

한 터미널에서 백엔드 서버를 실행하고 다른 터미널에서 프런트엔드 개발 서버를 실행하세요:

```bash
# Terminal 1: Backend
npm run server

# Terminal 2: Frontend
npm run dev
```

### 여러 SSH 세션

서로 다른 서버에 연결하세요:

```bash
# Terminal 1
ssh user@server1.com

# Terminal 2
ssh user@server2.com
```

휴대폰에서 두 서버를 모두 모니터링하세요.

## 세션 이름 지정

기본적으로 세션 이름은 포트 번호를 기준으로 지정됩니다. 의미 있는 이름을 지정하려면 `--session`을 사용하세요:

```bash
termbridge --session api-server
```

`TERMBRIDGE_SESSIONS`으로 여러 세션을 만들면 기본 이름 뒤에 숫자 접미사가 붙습니다.

## 지속성

- UI 연결을 끊어도 세션이 유지됩니다
- `--kill-on-exit`을 사용하는 경우를 제외하면 Termbridge이 재시작해도 세션이 유지됩니다
- 기존 세션에 다시 연결하려면 `--session <name>`을 사용하세요
