Cursor와 같은 AI 코딩 에이전트와 프로젝트 룰을 관리하기 위한 명령줄 인터페이스입니다.
npm install @vooster/cliCursor와 같은 AI 코딩 에이전트와 프로젝트 룰을 관리하기 위한 명령줄 인터페이스입니다.
- Node.js (버전 14 이상)
``bash`
npm install -g @vooster/cli
`bash`
vooster init
이 명령어는 다음을 수행합니다:
- OAuth 2.0을 통한 안전한 인증
- 프로젝트 선택
- 개발 도구 선택 (Cursor, Claude Code)
- 프로젝트 규칙 자동 다운로드
vooster init 또는 vooster init [projectUid]를 실행한 후에는 API 키가 자동으로 저장되어 다음 명령어들에서 별도로 입력할 필요가 없습니다.
Vooster 프로젝트에서 룰을 다운로드하고 설정합니다:
`bash`
vooster rules:init --agent cursor
이 명령어는 다음을 수행합니다:
- Vooster 서버에서 룰을 가져옵니다
- 지정된 에이전트용 룰 파일을 생성합니다
- 추적용 로컬 rules.json 파일을 생성합니다
로컬 룰 변경사항을 Vooster 서버로 업로드합니다:
`bash`
vooster rules:push --agent cursor
이 명령어는 다음을 수행합니다:
- 로컬 룰 파일을 읽습니다
- 서버로 변경사항을 업로드합니다
- 업로드된 룰의 요약을 표시합니다
프로젝트의 모든 태스크를 다운로드합니다:
`bash`
vooster tasks:download
- cursor: .cursor/rules/ 디렉토리에 적절한 frontmatter와 함께 .mdc 파일을 생성합니다vooster-docs/
- claude: 디렉토리와 CLAUDE.md 파일을 생성합니다
현재 지원하는 룰 타입:
- prd: 제품 요구사항 문서 룰
명령어 (src/commands/)
- rules-init.ts: 서버에서 룰을 다운로드하고 초기화 처리rules-push.ts
- : 로컬 룰을 서버로 업로드 처리_hof.ts
- : 미들웨어를 제공하는 고차 함수 (에러 처리, 프로젝트 검증)
API 레이어 (src/api/)
- _client.ts: 에러 처리가 포함된 Axios 기반 HTTP 클라이언트rules.ts
- : 룰 관련 API 엔드포인트 (가져오기/업로드 작업)
파일 관리 (src/utils/file/)
- base.ts: 구체적인 구현을 가진 추상 파일 시스템 인터페이스project-file.ts
- : .vooster/project.json 작업 처리rules-file.ts
- : 룰 파일 생성, 읽기, 파싱 관리constants.ts
- : 파일 경로 및 디렉토리 상수
유틸리티 (src/utils/)
- project.ts: 프로젝트 검증 및 UID 추출_error.ts
- : CLI 및 API 에러용 커스텀 에러 클래스
- 타입 안전성: TypeScript와 Zod 스키마 검증으로 구축
- 에이전트 추상화: 다양한 AI 코딩 에이전트를 위한 플러그형 아키텍처
- 에러 처리: 커스텀 에러 타입을 사용한 포괄적인 에러 처리
- 파일 시스템 추상화: 인터페이스 추상화를 통한 테스트 가능한 파일 작업
- 미들웨어 패턴: 조합 가능한 명령어 검증 및 에러 처리
`
.vooster/
├── project.json # 프로젝트 설정
└── rules.json # 로컬 룰 추적
.cursor/
└── rules/
└── vooster__*.mdc # Cursor용 생성된 룰 파일
`
Cursor용 룰 파일은 다음 구조를 따릅니다:
`markdown
---
description: 룰 설명
globs: *.ts
alwaysApply: true
---
마크다운 형식의 룰 내용
``