> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lasersell.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 참조

> LaserSell CLI 가이드: 데몬 동작, 로그 출력, 구성.

LaserSell CLI는 지갑을 모니터링하고 전략 조건이 충족되면 자동으로 청산을 실행하는 데몬으로 실행됩니다.

## 작동 방식

지갑을 잠금 해제한 후 CLI가 LaserSell 스트림에 연결하고 모니터링을 시작합니다. 모든 활동은 구조화된 로그 출력을 통해 터미널에 기록됩니다.

```shellscript theme={null}
lasersell
```

데몬은 **Ctrl+C**를 눌러 정상 종료할 때까지 실행됩니다.

## 로그 출력

CLI는 이벤트 발생 시 구조화된 이벤트를 출력합니다:

| 이벤트                   | 의미                      |
| --------------------- | ----------------------- |
| `startup`             | CLI 시작, 지갑 잠금 해제        |
| `stream_connected`    | LaserSell 스트림에 연결됨      |
| `wallet_registered`   | 서버와 지갑 소유권 검증           |
| `balance_update`      | SOL 잔액 폴링               |
| `session_started`     | 새 포지션 감지 및 모니터링 시작      |
| `pnl_update`          | 활성 포지션의 손익 업데이트         |
| `sell_scheduled`      | 청산 조건 트리거, 매도 대기열       |
| `sell_attempt`        | 매도 트랜잭션 제출              |
| `sell_complete`       | 온체인에서 매도 확인             |
| `session_closed`      | 포지션 완전 청산               |
| `liquidity_snapshot`  | 풀 유동성 업데이트 (추세 + 깊이 밴드) |
| `stream_disconnected` | 스트림 연결 끊김               |

## CLI 플래그

| 플래그                    | 단축   | 설명                                     |
| ---------------------- | ---- | -------------------------------------- |
| `--setup`              |      | 온보딩 마법사 강제 실행                          |
| `--config <path>`      | `-f` | 커스텀 구성 파일 경로                           |
| `--debug`              |      | `~/.lasersell/debug.log`에 디버그 수준 로그 작성 |
| `--smoke`              |      | 연결 헬스 체크 실행 후 종료                       |
| `--export-private-key` |      | 지갑의 base58 개인키를 stdout으로 내보내기          |

`--smoke`, `--setup`, `--export-private-key`는 상호 배타적입니다.

## 헤드리스 운영

CLI는 헤드리스 서버 배포를 위해 설계되었습니다. 자동 잠금 해제를 위해 환경 변수로 패스프레이즈를 설정합니다:

```shellscript theme={null}
export LASERSELL_WALLET_PASSPHRASE="your-passphrase"
lasersell
```

VPS에서는 `tmux` 또는 `screen` 세션에서 실행하거나 `systemd`를 사용하여 프로세스를 관리합니다.

## 청산 전략

CLI는 `~/.lasersell/config.yml`에 구성된 모든 LaserSell 청산 전략을 지원합니다:

| 전략        | 구성 필드                | 설명                            |
| --------- | -------------------- | ----------------------------- |
| 목표 수익     | `target_profit`      | 진입의 이 %에 수익이 도달하면 청산          |
| 손절매       | `stop_loss`          | 진입의 이 %에 손실이 도달하면 청산          |
| 트레일링 스탑   | `trailing_stop`      | 수익이 최고점에서 이 % 하락하면 청산         |
| 데드라인 타임아웃 | `deadline_timeout`   | N초 후 강제 청산                    |
| 졸업 시 매도   | `sell_on_graduation` | 토큰이 새 DEX로 마이그레이션 시 청산        |
| 청산 래더     | `take_profit_levels` | 여러 수익 임계값에서 부분 금액 매도          |
| 유동성 가드    | `liquidity_guard`    | 풀 유동성이 안전 임계값 아래로 떨어지면 청산     |
| 손익분기 트레일  | `breakeven_trail`    | 포지션이 손익분기에 도달하면 활성화되는 트레일링 스탑 |

최소 하나의 청산 조건이 활성화되어야 합니다. 전체 구성 참조는 [예제 구성](/onboarding/example-configuration)을 참조하세요.

## 카피 트레이딩

다른 지갑을 모니터링하고 선택적으로 매수 시 자동 매수:

```yaml theme={null}
watch_wallets:
  - pubkey: "TraderWallet1..."
    label: "whale"
  - pubkey: "TraderWallet2..."
    auto_buy:
      amount: 0.1       # SOL
      amount_usd1: 0.0   # USD1
```

감시 지갑의 포지션은 자신의 포지션과 동일한 청산 전략으로 관리됩니다.

## 전략 수정

`~/.lasersell/config.yml`을 편집하고 데몬을 재시작합니다. 변경사항은 다음 실행 시 적용됩니다.

설정 마법사를 다시 실행하려면:

```shellscript theme={null}
lasersell --setup
```