Skip to main content
vox CLI는 에이전트와 메뉴얼을 JSON 파일로 관리하는 도구예요. Git으로 변경을 검토하고, 코딩 에이전트와 함께 수정·검증한 뒤 vox.ai에 저장할 수 있어요. 파일 없이 대화로 작업하려면 플러그인을 쓰세요.

​
설치하고 로그인하기

npm으로 설치하세요. Homebrew를 쓰면 brew install vox-public/tap/vox로 설치할 수 있어요.
브라우저에서 vox.ai 계정으로 로그인하고 작업할 워크스페이스를 선택하세요.

​
연결 확인

로그인한 계정·워크스페이스와 원격 에이전트 목록을 확인하세요.

​
에이전트 만들거나 가져오기

빈 프로젝트 폴더를 만들고 그 안에서 시작하세요. 일반적인 대화형 업무는 Single 에이전트와 메뉴얼로 구성하세요. 현재 CLI는 유형을 생략하면 Flow로 만들기 때문에 single_prompt를 명시해요. 새 에이전트를 만들 때는 아래 명령을 실행하세요.
새로 만드는 경우 위 명령으로 생긴 agents/main/agent.json에서 에이전트 설정을, agents/main/manuals/reservation/manual.json에서 응대 절차를 작성하세요. 기존 에이전트를 가져올 때는 빈 폴더에서 아래 명령을 실행하세요. pull이 프로젝트를 함께 만들어요. <agent-id>에는 목록에서 확인한 ID를 넣으세요.

​
검증하고 저장하기

먼저 고친 파일을 검증하세요. reservation은 앞에서 만든 메뉴얼 이름이에요. 가져온 에이전트는 vox manual list --agent main에서 이름을 확인해 바꾸세요. 메뉴얼을 쓰지 않으면 manual 명령은 건너뛰세요.
이미 가져오거나 저장한 항목은 원격과의 차이도 확인하세요. 처음 만드는 항목은 비교할 원격 연결 정보가 없어 이 단계를 건너뛰어요.
검토한 내용을 저장하세요. agent push는 에이전트 설정만 저장하므로 메뉴얼은 따로 저장해요.

​
버전 저장하고 게시하기

저장을 마치면 원격의 현재 설정으로 버전을 만드세요.
운영에 반영할 준비가 됐을 때만 반환된 버전을 프로덕션에 지정하세요. 아래 v1을 저장 결과의 버전으로 바꾸세요.
push는 현재 설정 저장, version save는 버전 저장, promote는 프로덕션 지정이에요. 버전 관리에서 반영 범위를 확인할 수 있어요.

​
코딩 에이전트와 함께 쓰기

vox init은 Claude Code용 .claude/skills/vox-ai/SKILL.md와 Codex용 .codex/skills/vox-ai/SKILL.md를 만들어요. 같은 프로젝트에서 코딩 에이전트를 열고 작업을 요청하세요.
다른 코딩 에이전트에는 vox guide coding-agent --brief 출력을 지침으로 전달하세요. 로컬 스킬은 CLI 작업 지침이고 플러그인의 업무별 스킬과는 별도예요. 갱신과 CI 인증은 CLI 명령에서 확인하세요.

​
문제가 생겼을 때

vox auth login으로 다시 로그인한 뒤 vox auth whoami로 대상을 확인하세요. 저장된 다른 계정으로 바꾸려면 vox auth switch를 실행하세요.
CI 인증 설정에 따라 액세스 토큰과 워크스페이스를 환경 변수로 지정하세요.
vox agent skills refresh를 실행하세요. CLI가 관리하는 지침 파일을 최신 템플릿으로 갱신해요.

​
관련 문서