# 7. CLI 명령어 레퍼런스 ← [[openspec-06-slash-commands-reference|6. 슬래시 명령어 레퍼런스]] | 다음 → [[openspec-08-customization|8. 커스터마이징]] --- > [!info] > CLI 명령어는 터미널에서 실행한다. 슬래시 명령어([[openspec-06-slash-commands-reference|6장]])를 보완하며 프로젝트 설정, 검증, 관리에 사용한다. ## 7.1 설정 명령어 ```bash # 초기화 openspec init openspec init --tools claude,cursor # 특정 도구만 openspec init --tools all # 모든 도구 openspec init --profile core # 프로필 지정 openspec init --force # 레거시 파일 강제 정리 openspec init --no-interactive # 비대화형 (CI용) # 업데이트 openspec update # 최신 버전으로 openspec update --force # 최신이어도 강제 업데이트 ``` **지원 도구 값:** `amazon-q`, `claude`, `cursor`, `github-copilot`, `windsurf`, `continue`, `cline`, `codex`, `gemini`, `kimi`, `kiro`, `roocode` 등 (전체 목록: [[openspec-09-supported-tools-and-integration|9장]]) ## 7.2 탐색 명령어 ```bash # 변경사항 목록 openspec list # 기본 (변경사항) openspec list --changes # 변경사항만 openspec list --specs # 스펙만 openspec list --sort recent # 최근 순 openspec list --sort name # 이름 순 openspec list --json # JSON 출력 # 대시보드 (인터랙티브) openspec view # 변경사항 상세 openspec show add-dark-mode openspec show add-dark-mode --deltas-only # 델타 스펙만 openspec show add-dark-mode --requirements # 요구사항만 openspec show add-dark-mode -r REQ-001 # 특정 요구사항 openspec show add-dark-mode --json # JSON 출력 openspec show add-dark-mode --type change # change 또는 spec 지정 ``` ## 7.3 검증 명령어 ```bash openspec validate # 기본 검증 openspec validate --all # 전체 검증 openspec validate --changes # 변경사항만 openspec validate --specs # 스펙만 openspec validate --strict # 엄격 모드 openspec validate --concurrency 10 # 병렬 처리 수 (기본: 6) openspec validate --json # JSON 출력 openspec validate --no-interactive # 비대화형 (CI용) ``` ## 7.4 라이프사이클 명령어 ```bash openspec archive add-dark-mode openspec archive add-dark-mode -y # 확인 프롬프트 생략 openspec archive add-dark-mode --skip-specs # 스펙 업데이트 생략 openspec archive add-dark-mode --no-validate # 검증 생략 ``` ## 7.5 워크플로우 명령어 ```bash # 변경사항 상태 조회 (아티팩트 완료 현황) openspec status openspec status --change add-dark-mode openspec status --change add-dark-mode --json # AI에게 전달할 지시사항 출력 openspec instructions openspec instructions --change add-dark-mode openspec instructions proposal # 특정 아티팩트 지시사항 openspec instructions --json # 사용 가능한 템플릿 목록 openspec templates openspec templates --schema my-workflow openspec templates --json # 사용 가능한 스키마 목록 openspec schemas openspec schemas --json ``` ## 7.6 설정 명령어 ```bash openspec config path # 설정 파일 위치 표시 openspec config list # 모든 설정 표시 openspec config get schema # 특정 값 조회 openspec config set schema my-workflow # 값 설정 openspec config unset schema # 키 제거 openspec config reset --all --yes # 기본값으로 초기화 openspec config edit # 에디터에서 열기 openspec config profile # 프로필 설정 (대화형) ``` ## 7.7 스키마 명령어 ```bash # 새 스키마 생성 openspec schema init my-workflow openspec schema init my-workflow --description "연구 우선 워크플로우" openspec schema init my-workflow --artifacts proposal,research,design,tasks openspec schema init my-workflow --default # 기본 스키마로 설정 # 기존 스키마 복제 openspec schema fork spec-driven my-workflow # 검증 openspec schema validate my-workflow openspec schema validate my-workflow --verbose # 현재 사용 중인 스키마 확인 openspec schema which openspec schema which --all # 모든 스키마와 출처 ``` ## 7.8 워크스페이스 명령어 > [!warning] 베타 기능 > 워크스페이스 기능은 활발히 개발 중이다. 프로덕션 환경에서는 안정성을 충분히 검증한 후 사용한다. ```bash # 설정 openspec workspace setup --name my-project \ --link frontend=./packages/frontend \ --link backend=./packages/backend # 목록 openspec workspace list openspec workspace ls --json # 링크 관리 openspec workspace link openspec workspace relink # 로컬 경로 재연결 # 상태 확인 openspec workspace doctor # 열기 openspec workspace open --workspace my-project openspec workspace open --agent claude openspec workspace open --editor # VS Code 에디터 모드 ``` ## 7.9 유틸리티 명령어 ```bash # 피드백 전송 openspec feedback --body "기능 제안: ..." # 쉘 자동완성 openspec completion install # 현재 쉘에 설치 openspec completion install bash openspec completion install zsh openspec completion install fish openspec completion install powershell openspec completion generate zsh # 스크립트만 출력 # 전역 옵션 openspec --version openspec --no-color openspec --help openspec <명령어> --help # 특정 명령어 도움말 ``` ## 7.10 환경 변수 ### bash / zsh / fish ```bash export OPENSPEC_TELEMETRY=0 export DO_NOT_TRACK=1 export OPENSPEC_CONCURRENCY=10 export EDITOR=code export NO_COLOR=1 ``` ### PowerShell (Windows) ```powershell $env:OPENSPEC_TELEMETRY = "0" $env:DO_NOT_TRACK = "1" $env:OPENSPEC_CONCURRENCY = "10" $env:EDITOR = "code" $env:NO_COLOR = "1" ``` ### 환경 변수 전체 목록 | 변수 | 설명 | 기본값 | |------|------|--------| | `OPENSPEC_TELEMETRY` | `0` 설정 시 원격 측정 비활성화 | 활성화 | | `DO_NOT_TRACK` | `1` 설정 시 원격 측정 비활성화 (표준 DNT) | — | | `OPENSPEC_CONCURRENCY` | 대량 검증 병렬 처리 수 | `6` | | `EDITOR` 또는 `VISUAL` | `openspec config edit` 사용 에디터 | 시스템 기본값 | | `NO_COLOR` | 설정 시 색상 출력 비활성화 | — | ## 7.11 종료 코드 | 코드 | 의미 | 발생 상황 | |------|------|-----------| | `0` | 성공 | 정상 완료 | | `1` | 오류 | 검증 실패, 파일 누락, 일반 오류 | | `130` | 사용자 중단 | Ctrl+C 입력 | > [!tip] CI/CD에서 종료 코드 활용 > ```yaml > - name: Validate specs > run: openspec validate --all --strict --no-interactive > # 실패 시 exit code 1 → 파이프라인 중단 > ``` --- ← [[openspec-06-slash-commands-reference|6. 슬래시 명령어 레퍼런스]] | 다음 → [[openspec-08-customization|8. 커스터마이징]]