문서 / CLI 명령 참조

CLI 명령 참조

CLI를 설치하고 프로젝트에 연결해 보세요. 주요 명령과 문제 신고, 개선 제안, 토큰 폐기 방법을 안내합니다.

설치와 버전 확인

조립스페이스 CLI를 사용하면 터미널에서 프로젝트에 연결하고 배포, 데이터, 설정을 관리할 수 있습니다. 이 가이드는 CLI 0.6.1을 기준으로 합니다. 아래 명령으로 설치된 버전을 확인하고 npm의 최신 버전으로 업데이트해 보세요. 설치가 끝나면 버전을 다시 확인합니다.

CLI

joripspace --version
npm view @joripspace/cli@latest version
npm install -g @joripspace/cli@latest
joripspace --version

Node.js 18 이상과 npm이 필요합니다. 전역 설치 없이 실행하려면 npx -y @joripspace/cli@latest를 사용하세요. 예제의 PROJECT는 기존 프로젝트 이름으로 바꿉니다.

업데이트 후에도 버전이 그대로라면 터미널이 이전 설치본을 실행하고 있을 수 있습니다. PowerShell에서는 Get-Command joripspace -All, macOS와 Linux에서는 command -v joripspace로 실행 파일의 위치를 확인할 수 있습니다.

프로젝트 연결

CLI

joripspace login
joripspace projects
joripspace start PROJECT --json

login을 실행한 뒤 브라우저에서 연결을 승인하고, 발급된 일회용 코드를 5분 안에 입력하세요. 프로젝트 목록을 확인하고 start로 연결하면 현재 상태와 다음 작업이 안내됩니다. AI 에이전트에서는 입력을 기다리지 않는 login --code "CONNECTION_CODE" --json으로 코드를 전달할 수 있습니다.

새 프로젝트가 필요하면 create --name NAME을 실행하고 필수 동의 절차를 진행하세요. CLI 로그인 정보는 컴퓨터에 저장되어 다음 작업에서도 재사용할 수 있습니다. MCP 클라이언트는 별도로 로그인합니다.

다른 폴더에서 작업하려면 --cwd "PROJECT_FOLDER"를 추가하세요. 연결된 프로젝트 이름은 .joripspace/project에 기록됩니다. 로컬 로그인 파일인 .env.joripspace는 Git·배포·저장본에서 제외해 주세요. logout으로 저장된 로그인 정보를 지울 수 있습니다. 노출된 토큰을 서버에서도 사용 중지하려면 아래 토큰 폐기 안내를 참고하세요.

명령 참조

아래 표에서 하려는 작업에 맞는 명령을 찾아보세요. 사용할 수 있는 옵션은 CLI 도움말에서 확인할 수 있습니다. deploy와 report처럼 전용 도움말이 있는 명령도 있습니다. 전체 도움말이 표시되는 경우에는 그 목록에서 명령 이름과 옵션을 확인하세요.

명령	용도
`login · logout`	로그인과 저장된 로그인 정보 삭제
`me · projects · get`	계정의 프로젝트와 선택한 프로젝트 상태 조회
`create · start · link`	새 프로젝트 생성·기존 프로젝트 연결
`templates · template list · install-template · template pull`	템플릿 탐색·설치·업데이트
`db schema · db query · db migrate`	스키마 확인·SQL 실행·마이그레이션
`storage list · storage get · storage put · storage delete`	업로드 파일 조회·등록·삭제
`deploy · deployments · deployment get · deployment pull · rollback`	배포·배포 이력·소스 복원·롤백
`checkpoint save · list · get · update · restore · deploy · delete`	작업 저장본 관리·로컬 복원·배포
`secret list · generate · set · update`	비밀 키 이름 확인·생성·등록·교체
`domains · domain create · verify · delete`	도메인 연결·검증·삭제
`crons · cron create · run · delete`	예약 작업 관리·실행
`mail connect · status · test`	메일 연결·상태·테스트 발송
`realtime-v2 status · activate · rotate · keys · revoke-key · docs`	실시간 기능과 서명 키 관리
`events · usage-summary · usage-breakdown`	오류·사용량 조회
`github prepare · knowledge search`	GitHub 작업 흐름 준비·운영 지식 검색
`report`	문제·버그 신고와 피드백 전송
`tokens current · tokens revoke`	토큰 ID 확인과 폐기

CLI

joripspace --help
joripspace deploy --help
joripspace report --help

공통 옵션	동작
`--project PROJECT`	이 옵션을 지원하는 명령에서 작업할 프로젝트를 지정합니다.
`--cwd PATH`	지정한 폴더에서 프로젝트와 저장된 로그인 정보를 찾습니다.
`--json`	에이전트·스크립트에서 사용할 결과를 JSON으로 받습니다. 브라우저를 열거나 입력을 기다리지 않으며, 권한과 필수 동의 절차는 그대로 적용됩니다.
`--api-url URL`	연결할 API 주소를 지정합니다.

문제 신고와 개선 제안

CLI

joripspace report --project PROJECT --category bug --summary "Deployment status is incorrect" --details "Reproduction steps" --json
joripspace report --project PROJECT --category feedback --summary "Add deployment history filters" --expected "Search by label" --json

report로 프로젝트 작업 중 겪은 문제나 개선 아이디어를 조립스페이스에 보낼 수 있습니다. 일반적인 문제는 problem, 버그는 bug, 개선 제안은 feedback으로 선택하세요. 개선 제안은 report --category feedback으로 보냅니다. feedback 분류와 report 전용 도움말은 CLI 0.6.1 이상에서 사용할 수 있습니다.

프로젝트에 연결한 상태에서 간단한 요약을 작성하세요. --details에는 상황이나 재현 과정을, --expected와 --actual에는 원하는 동작과 현재 동작을 적을 수 있습니다. 오류 코드가 있다면 --error-code로 함께 보내세요. CLI·Node.js·OS 정보는 자동으로 첨부됩니다.

전송 전에 내용을 확인하고 비밀 키·개인정보·비공개 소스는 제외해 주세요. 에이전트와 작업 중이라면 보낼 준비가 됐을 때 신고를 요청하면 됩니다. 접수가 완료되면 응답에 접수번호인 report_id가 표시됩니다. 응답이 끊겨도 이미 접수됐을 수 있으므로 같은 신고를 반복해서 보내지 않도록 주의하세요.

노출된 연결 토큰 폐기

CLI

joripspace tokens current
joripspace tokens revoke --current

연결 토큰이 노출됐다면 폐기해 더 이상 사용할 수 없도록 할 수 있습니다. tokens current로 비밀값을 표시하지 않고 현재 토큰 ID를 확인한 뒤, tokens revoke --current로 서버에서 사용 중지하세요. 이 명령은 CLI 0.6.1 이상에서 사용할 수 있습니다.

토큰을 폐기하면 같은 토큰을 사용하는 MCP 세션도 함께 연결이 끊깁니다. 이후에는 새 연결 코드로 다시 연결해야 합니다.

CLI

joripspace tokens revoke --token-id TOKEN_ID

예전에 사용하던 토큰을 폐기하려면 같은 계정의 다른 유효한 토큰으로 로그인하고, TOKEN_ID에 폐기할 토큰의 ID를 넣으세요. 실행 전에 대상 ID를 확인해 주세요. 웹 프로필의 API 토큰 화면에서도 사용 중지할 수 있습니다. logout은 컴퓨터에 저장된 로그인 정보를 지우는 명령이므로, 서버 접근까지 막으려면 토큰 폐기를 사용합니다.

문서 전체 보기 프로젝트 열기