CLI 참조¶
명령어¶
codexspec show-blueprint¶
고정 브랜치 codexspec/auto-dev와 worktree-for-codexspec-auto-dev의 전체
.codexspec/blueprint.md를 표준 출력에 원문 그대로 표시합니다. 저장소, 브랜치, worktree 또는
파일이 없으면 표준 오류에 진단을 출력하고 0이 아닌 상태로 종료합니다. 읽기 전용이며 fetch,
merge, 쓰기 또는 잠금을 수행하지 않습니다.
codexspec init¶
새 CodexSpec 프로젝트를 초기화합니다.
인자:
| 인자 | 설명 |
|---|---|
PROJECT_NAME |
새 프로젝트 디렉토리의 이름(현재 디렉토리는 . 또는 --here 사용) |
옵션:
| 옵션 | 단축 | 설명 |
|---|---|---|
--here |
-h |
현재 디렉토리에서 초기화 |
--ai |
-a |
사용할 AI 어시스턴트: claude, codex, 또는 both (기본값: claude) |
--lang |
-l |
출력(기반) 언어; interaction/document/commit이 여기로 폴백 (예: en, zh-CN, ja) |
--interaction-lang |
상호작용 언어(LLM 대화 + codexspec CLI 출력); --lang을 덮어씀 |
|
--document-lang |
문서 언어(생성된 requirements/spec/plan/tasks); --lang을 덮어씀 |
|
--commit-lang |
커밋 메시지 언어; --lang을 덮어씀 |
|
--force |
-f |
기존 파일을 덮어쓰고 프롬프트를 자동 확정; config.yml은 재생성하지 않음 |
--no-git |
git 리포지토리 초기화 건너뛰기 | |
--debug |
-d |
디버그 출력 활성화 |
--lang은 output 기반 언어를 설정하며, --interaction-lang, --document-lang, --commit-lang은 각자의 차원에서 이를 덮어씁니다(각각 output → en 순으로 폴백). 전체 모델은 국제화를 참조하세요.
TTY 환경에서 --lang(그리고 세 차원 플래그 모두) 없이 처음 init을 실행하면 기반 언어를 묻습니다. non-TTY(CI/스크립트)에서는 en이 기본값이 되며 완전히 비대화형으로 동작합니다. init을 다시 실행할 때 지정하지 않은 언어 키는 보존되며, --force는 절대 config.yml을 재생성하지 않습니다.
예제:
# 새 프로젝트 생성
codexspec init my-project
# 현재 디렉토리에서 초기화
codexspec init . --ai claude
# 일회성 실행(설치 없음) — Codex CLI 또는 both 로 초기화
uvx codexspec init . --ai codex
uvx codexspec init . --ai both
# 완전한 비대화형: zh-CN 기반, 영어 커밋 메시지
codexspec init my-project --lang zh-CN --commit-lang en
# 모든 차원을 명시적으로 설정(스크립트용, 프롬프트 없음)
codexspec init my-project \
--interaction-lang zh-CN --document-lang en --commit-lang en
codexspec check¶
설치된 도구를 확인합니다.
codexspec version¶
버전 정보를 표시합니다.
codexspec config¶
프로젝트 설정을 보거나 수정합니다.
옵션:
| 옵션 | 단축 | 설명 |
|---|---|---|
--set-lang |
-l |
출력(기반) 언어 설정 |
--set-interaction-lang |
상호작용 언어 설정(LLM 대화 + CLI 출력) | |
--set-document-lang |
문서 언어 설정(생성된 spec/plan/tasks) | |
--set-commit-lang |
-c |
커밋 메시지 언어 설정 |
--list-langs |
지원하는 모든 언어 나열 | |
--auto-next |
workflow.auto_next 토글/설정(플래그만 쓰면 토글, 또는 on/off 명시) |
각 --set-*-lang은 하나의 언어 차원을 업데이트합니다. 설정하지 않은 차원은 output → en 순으로 폴백합니다.