MayDay-wpf/snow-cli

영어 (English) | 중국어 (中文)

QQ 그룹 (QQ Group): 910298558

텔레그램 (Telegram): https://t.me/snow_cli

AI 커뮤니티 (AI Community): https://linux.do

터미널에서의 에이전틱 코딩 (Agentic coding in your terminal)

후원자 (Sponsor)	설명 (Description)
acker798.xyz	AI 중계 스테이션 (AI Relay Station), Codex 지원
JetBrains	오픈 소스 프로젝트 후원자, 무료 IDE 라이선스 제공

PowerShell 7+: 더 강력한 기능과 더 나은 호환성을 제공하는 현대적인 크로스 플랫폼 (cross-platform) PowerShell
Windows Terminal: 멀티 탭, 분할 화면 및 GPU 가속 렌더링을 지원하는 현대적인 터미널 애플리케이션

설치 (Installation):

# winget을 사용하여 설치 (Windows 10/11 내장)
winget install Microsoft.PowerShell
winget install Microsoft.WindowsTerminal
...

• 설치 가이드 (Installation Guide) - 시스템 요구 사항, 설치 (업데이트, 삭제) 단계, IDE 확장 프로그램 설치

• 초기 설정 (First Time Configuration) - API 설정, 모델 선택, 기본 설정

• 시작 매개변수 가이드 (Startup Parameters Guide) - 명령줄 매개변수 설명, 빠른 시작 모드, 헤드리스 모드 (headless mode), 비동기 작업 (async tasks), 개발자 모드

• 프록시 및 브라우저 설정 (Proxy and Browser Settings) - 네트워크 프록시 설정, 브라우저 사용 설정

• 코드베이스 설정 (Codebase Setup) - 코드베이스 통합, 검색 설정

• 서브 에이전트 설정 (Sub-Agent Configuration) - 서브 에이전트 관리, 커스텀 서브 에이전트 설정

• 민감한 명령 설정 (Sensitive Commands Configuration) - 민감한 명령 보호, 커스텀 명령 규칙

• 훅 설정 (Hooks Configuration) - 워크플로우 자동화, 훅 유형 설명, 실제 설정 예시

• 테마 설정 (Theme Settings) - 인터페이스 테마 설정, 커스텀 색상 구성표, 간소화 모드

• 제3자 중계 설정 (Third-Party Relay Configuration) - Claude Code 중계, Codex 중계, 커스텀 헤더 설정

• 커맨드 패널 가이드 (Command Panel Guide) - 사용 가능한 모든 명령에 대한 상세 설명, 사용 팁, 단축키 참조 (카테고리별로 09.1~09.7 하위 문서로 분할)

• 커맨드 인젝션 모드 (Command Injection Mode) - 메시지 내에서 명령을 직접 실행, 구문 설명, 보안 메커니즘, 사용 사례

• 취약점 탐색 모드 (Vulnerability Hunting Mode) - 전문적인 보안 분석, 취약점 탐지, 검증 스크립트, 상세 보고서

• 헤드리스 모드 (Headless Mode) - 커맨드 라인(CLI) 빠른 대화, 세션 관리, 스크립트 통합, 제3자 도구 통합

• 키보드 단축키 가이드 (Keyboard Shortcuts Guide) - 모든 키보드 단축키, 편집 작업, 탐색 제어, 롤백 (Rollback) 기능

• MCP 설정 (MCP Configuration) - MCP 서비스 관리, 외부 서비스 설정, 서비스 활성화/비활성화, 문제 해결 (Troubleshooting)

• 비동기 작업 관리 (Async Task Management) - 백그라운드 작업 생성, 작업 관리 인터페이스, 민감한 명령 승인, 작업을 세션으로 변환

• 스킬 커맨드 상세 가이드 (Skills Command Detailed Guide) - 스킬 생성, 사용 방법, Claude Code Skills 호환성, 도구 제한 사항

• LSP 설정 및 사용 (LSP Configuration and Usage) - LSP 설정 파일, 언어 서버 (Language Server) 설치, ACE 도구 사용 (정의/개요)

• SSE 서비스 모드 (SSE Service Mode) - SSE 서버 시작, API 엔드포인트(Endpoints) 설명, 도구 확인 흐름, 권한 설정, YOLO 모드, 클라이언트 통합 예시

• 커스텀 상태 표시줄 가이드 (Custom StatusLine Guide) - 사용자 수준의 StatusLine 플러그인, 훅 (Hook) 구조, 오버라이드 (Override) 동작, 이중 언어 예시

• 팀 모드 가이드 (Team Mode Guide) - 멀티 에이전트 (Multi-agent) 협업, 병렬 작업 실행, 팀 관리

• 커스텀 검색 엔진 가이드 (Custom Search Engine Guide) - 사용자 수준의 검색 엔진 플러그인, 엔진 계약 (Contract), 활성화 플래그, 최소 템플릿

• 권장 ROLE.md - Snow CLI 터미널 프로그래밍 어시스턴트를 위한 권장 행동 지침, 작업 모드 및 품질 표준

• 이중 언어 문서: 영어 (주 언어) / 중국어

• 유지보수 규칙: 중국어와 영어 구조를 일치시킬 것; 도구 이름은 변경하지 말 것

Node.js >= 18.x(ES2020 기능 지원 필요)- npm >= 8.3.0

Node.js 버전을 확인하세요:

node --version

버전이 18.x 미만인 경우, 먼저 업그레이드해 주세요:

# nvm 사용 (권장)
nvm install 18
nvm use 18
...

git clone https://github.com/MayDay-wpf/snow-cli.git
cd snow-cli
npm install
...

• Extension (확장 프로그램) 소스는
  VSIX/

디렉토리에 위치합니다 - 릴리스 다운로드: mufasa.snow-cli

• Plugin (플러그인) 소스는
  Jetbrains/

디렉토리에 위치합니다 - 릴리스 다운로드: JetBrains plugin

source/ # 소스 코드
├── agents/ # AI 에이전트 (AI agents) 구현
├── api/ # LLM API 어댑터 (LLM API adapters)
...

snow를 실행한 후에는, 홈 폴더에 .snow/

디렉토리가 생성됩니다:

~/.snow/ # 사용자 설정 디렉토리 (User configuration directory)
├── log/ # 런타임 로그 (Runtime logs) (로컬, 삭제 가능)
├── profiles/ # 설정 프로필 (Configuration profiles)
...