starhui-dev/huly-cli

Huly CLI

@firfi/huly-mcp를 통해 Huly와 작업하려면 npx -y @starhui/huly-cli@latest를 사용하세요.

이 저장소 내에서 로컬 개발을 하는 경우, pnpm build && pnpm link --global 후에는 huly도 사용할 수 있습니다.

빠른 확인

1. CLI가 사용 가능한지 확인합니다:

   npx -y @starhui/huly-cli@latest --version
   

2. 먼저 기존 환경 변수에서 필터링된 구성을 확인합니다:

   npx -y @starhui/huly-cli@latest context
   

3. 필요한 구성이 누락된 경우, 사용자에게 --config <path>로 명시적인 dotenv 파일을 전달할지 물어봅니다.
4. 이슈 명령에서 프로젝트가 생략된 경우, HULY_DEFAULT_PROJECT를 설정하거나 --project를 전달합니다.

실제 토큰, 비밀번호 또는 전체 .env 내용을 절대 출력하지 마십시오. npx -y @starhui/huly-cli@latest context는 필터링된 구성을 반환하므로 안전합니다.

일반 명령어

프로젝트 목록:

npx -y @starhui/huly-cli@latest project list --json

이슈를 생성하거나 업데이트하기 전에 상태(Status)를 확인합니다:

npx -y @starhui/huly-cli@latest project statuses HULY --json

이슈 목록:

npx -y @starhui/huly-cli@latest issue list --project HULY --status-category active --limit 20 --json

이슈 조회:

npx -y @starhui/huly-cli@latest issue get HULY-123 --project HULY --json

이슈 생성:

npx -y @starhui/huly-cli@latest issue create --project HULY --title "짧은 명령형 제목" --description "Markdown 본문"

이슈 업데이트:

npx -y @starhui/huly-cli@latest issue update HULY-123 --project HULY --status Done

검색:

npx -y @starhui/huly-cli@latest search "검색어" --limit 10 --json

원시 도구 액세스

일급 CLI가 업스트림 MCP 도구를 노출하지 않는 경우 원시 호출을 사용합니다:

npx -y @starhui/huly-cli@latest tools --filter document
npx -y @starhui/huly-cli@latest call get_issue --field project=HULY --field identifier=HULY-123 --json
npx -y @starhui/huly-cli@latest call list_projects --data '{"limit":10}' --json

--field key=value는 true, false, null, 숫자를 강제 변환합니다. 중첩된 JSON에는 --data 또는 --file을 사용하세요.

안전

• 에이전트 파싱을 위해 --json을 사용하세요.
• 쓰기 전에 읽기: 사용자가 정확한 값을 제공하지 않는 한, 프로젝트/상태/이슈를 변경하기 전에 먼저 검사합니다.
• 파괴적인 명령은 확인이 필요합니다. 사용자가 명시적으로 삭제를 요청한 경우에만 --yes를 전달하세요.
• project statuses의 상태 이름을 사용하고, 워크플로우 상태를 임의로 만들지 마십시오.
• 명령이 인증/구성 오류로 실패하면, npx -y @starhui/huly-cli@latest context에서 누락된 필터링된 필드를 보고하고 비밀 정보를 노출하지 마십시오. 사용자가 사용할 dotenv 파일을 확인한 후에만 --config <path>로 재시도하세요.

유용한 매핑

• 프로젝트: project list, project get, project statuses, project create, project update, project delete.
• 이슈: issue list, issue get, issue create, issue update, issue delete, issue label, issue unlabel, issue move.
• 전체 검색: search.
• 모든 업스트림 MCP 도구: tools 및 call.