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

# CLI 레퍼런스

> Decepticon CLI의 모든 명령어와 옵션에 대한 완전한 레퍼런스.

## 개요

Decepticon은 **CLI 우선**입니다. 보안 작업은 터미널에 속합니다. — 브라우저 탭, 대시보드, 컨텍스트 전환이 필요 없습니다. 인터페이스는 [Ink](https://github.com/vadimdemedes/ink)로 구축된 실시간 스트리밍 CLI로, 에이전트가 보는 것을 보여줍니다.

CLI는 Go 기반 런처(`decepticon`)로 제공되며, 기본 Docker 스택을 조율하고 React/Ink 대화형 UI를 엽니다.

## 최상위 명령어

### `decepticon`

모든 서비스를 시작하고 대화형 CLI를 엽니다.

```bash theme={null}
decepticon
```

전체 스택을 시작합니다. — 에이전트 API 서버, LiteLLM 프록시, Kali 샌드박스, PostgreSQL, Neo4j, 선택적 Sliver C2 — 그리고 스트리밍 CLI를 엽니다. 인게이지먼트를 생성하고 실행하기 위한 주요 진입점입니다.

### `decepticon onboard`

대화형 설정 마법사를 실행합니다.

```bash theme={null}
decepticon onboard
decepticon onboard --reset    # 처음부터 재설정
```

구성:

* LLM 제공자 및 API 키(Anthropic, OpenAI, Google, MiniMax, Claude 구독을 통한 Anthropic OAuth)
* 인증 우선 순위 순서
* 모델 프로필(`eco`, `max`, `test`)
* LangSmith 추적 토글 및 키

마법사는 `.env`를 작성하고 제공자 순서를 유지합니다. `--reset`을 사용하여 기존 설정을 버립니다.

### `decepticon demo`

가이드 데모를 실행합니다.

```bash theme={null}
decepticon demo
```

Metasploitable 2를 대상으로 실행하고, 사전 구축된 인게이지먼트(RoE, ConOps, OPPLAN)를 로드하고, 전체 킬 체인을 자율적으로 실행합니다. — 포트 스캔, vsftpd 익스플로잇, Sliver C2 임플란트 배포, 자격증명 수집, 내부 정찰.

<Info>
  데모는 Decepticon의 작동을 보는 가장 빠른 방법입니다. API 키 외에 추가 설정이 필요하지 않습니다.
</Info>

### `decepticon status`

서비스 상태를 표시합니다.

```bash theme={null}
decepticon status
```

스택의 각 Docker 서비스를 현재 상태로 나열합니다. — 실행 중, 중지됨, 재시작 중 — 그리고 노출 포트. CLI를 실행하기 전에 스택이 깨끗하게 올라왔는지 확인하는 데 유용합니다.

### `decepticon logs [service]`

서비스 로그를 추적합니다.

```bash theme={null}
decepticon logs                  # 모든 서비스 추적
decepticon logs langgraph        # LangGraph 플랫폼만
decepticon logs litellm          # LLM 프록시
decepticon logs sandbox          # Kali 샌드박스
decepticon logs postgres         # 데이터베이스
decepticon logs neo4j            # 지식 그래프
decepticon logs web              # Next.js 대시보드
```

`docker compose logs -f` 스타일로 로그를 스트림합니다. 가장 일반적인 디버깅 진입점입니다. — Decepticon이 오작동하면, 여기를 먼저 확인하세요.

### `decepticon kg-health`

지식 그래프를 진단합니다.

```bash theme={null}
decepticon kg-health
```

Neo4j 연결 및 스키마 확인을 실행합니다. 고아 노드, 누락된 관계, 제약 위반을 보고합니다. 장기 인게이지먼트 후 전달물을 내보내기 전에 유용합니다.

### `decepticon stop`

모든 서비스를 중지합니다.

```bash theme={null}
decepticon stop
```

모든 Docker 컨테이너를 우아하게 중지합니다. — 에이전트 API, LiteLLM 프록시, 샌드박스, C2 서버, 데이터베이스, 지식 그래프, 웹 대시보드.

### `decepticon update`

업데이트를 확인하고 적용합니다.

```bash theme={null}
decepticon update
```

GHCR에서 더 새로운 사전 구축 이미지를 확인하고 로컬 설치를 업데이트합니다. 런처 자체는 설치 스크립트를 통해 별도로 업데이트됩니다.

### `decepticon remove`

Decepticon을 제거합니다.

```bash theme={null}
decepticon remove
```

모든 컨테이너를 해제하고, 이미지를 제거하고, 인게이지먼트 워크스페이스를 삭제합니다. 주의해서 사용하세요. — 명시적으로 먼저 내보내지 않으면 인게이지먼트 데이터가 제거됩니다.

### `decepticon --version`

런처 버전을 표시합니다.

```bash theme={null}
decepticon --version
```

## C2 프로필

Docker Compose 프로필을 통해 C2 프레임워크를 활성화합니다. 기본 설치는 `c2-sliver`를 활성화합니다.

```bash theme={null}
# Sliver C2와 함께 시작(기본)
COMPOSE_PROFILES=c2-sliver decepticon

# Sliver C2와 데모 대상 스택과 함께 시작
COMPOSE_PROFILES=c2-sliver,demo decepticon
```

## CLI 키바인딩

대화형 CLI는 다음 키 단축키를 노출합니다:

| 키        | 작업                        |
| -------- | ------------------------- |
| `Ctrl+O` | 프롬프트 ↔ 성적표 보기 전환          |
| `Ctrl+G` | 그래프 사이드바 순환(개요 / 노드 / 흐름) |
| `Ctrl+B` | 사이드바 표시 여부 전환             |
| `Ctrl+C` | 현재 작업 취소 / 최상위에서 있으면 종료   |
| `Esc`    | 성적표 보기 종료                 |

## 슬래시 명령어

CLI 프롬프트 내에서 호출할 수 있습니다:

| 명령어             | 작업                                            |
| --------------- | --------------------------------------------- |
| `/help`         | 인라인 도움말 표시                                    |
| `/clear`        | 현재 대화 지우기                                     |
| `/resume [msg]` | 마지막 인게이지먼트 재개; 선택적 메시지 추가됨                    |
| `/quit`         | CLI 종료(서비스 계속 실행; 중지하려면 `decepticon stop` 사용) |

## 개발자 명령어

Decepticon 자체에서 작업하는 기여자:

```bash theme={null}
make dev          # 빌드 + 핫리로드로 시작 (docker compose watch)
make cli          # 대화형 CLI 열기(별도 터미널)
make start        # 백그라운드에서 시작(프로덕션 유사, 핫리로드 없음)
make stop         # 모든 서비스 중지
make test         # 컨테이너 내에서 pytest 실행
make lint         # 로컬에서 린트 + 타입 확인(필수: uv sync --dev)
make help         # 사용 가능한 모든 Makefile 대상 표시
```

<Card title="개발자 설정" icon="code" href="/ko/contributing/developer-setup">
  기여자를 위한 전체 개발 환경 설정 가이드.
</Card>