메인 콘텐츠로 건너뛰기

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.

개요

Decepticon은 CLI 우선입니다. 보안 작업은 터미널에 속합니다. — 브라우저 탭, 대시보드, 컨텍스트 전환이 필요 없습니다. 인터페이스는 Ink로 구축된 실시간 스트리밍 CLI로, 에이전트가 보는 것을 보여줍니다. CLI는 Go 기반 런처(decepticon)로 제공되며, 기본 Docker 스택을 조율하고 React/Ink 대화형 UI를 엽니다.

최상위 명령어

decepticon

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

decepticon onboard

대화형 설정 마법사를 실행합니다.
decepticon onboard
decepticon onboard --reset    # 처음부터 재설정
구성:
  • LLM 제공자 및 API 키(Anthropic, OpenAI, Google, MiniMax, Claude 구독을 통한 Anthropic OAuth)
  • 인증 우선 순위 순서
  • 모델 프로필(eco, max, test)
  • LangSmith 추적 토글 및 키
마법사는 .env를 작성하고 제공자 순서를 유지합니다. --reset을 사용하여 기존 설정을 버립니다.

decepticon demo

가이드 데모를 실행합니다.
decepticon demo
Metasploitable 2를 대상으로 실행하고, 사전 구축된 인게이지먼트(RoE, ConOps, OPPLAN)를 로드하고, 전체 킬 체인을 자율적으로 실행합니다. — 포트 스캔, vsftpd 익스플로잇, Sliver C2 임플란트 배포, 자격증명 수집, 내부 정찰.
데모는 Decepticon의 작동을 보는 가장 빠른 방법입니다. API 키 외에 추가 설정이 필요하지 않습니다.

decepticon status

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

decepticon logs [service]

서비스 로그를 추적합니다.
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

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

decepticon stop

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

decepticon update

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

decepticon remove

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

decepticon --version

런처 버전을 표시합니다.
decepticon --version

C2 프로필

Docker Compose 프로필을 통해 C2 프레임워크를 활성화합니다. 기본 설치는 c2-sliver를 활성화합니다.
# 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]마지막 인게이지먼트 재개; 선택적 메시지 추가됨
/quitCLI 종료(서비스 계속 실행; 중지하려면 decepticon stop 사용)

개발자 명령어

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

개발자 설정

기여자를 위한 전체 개발 환경 설정 가이드.