hasa CLI

게이트웨이 API를 소비해 모델·템플릿을 탐색하고, AppSpec을 검증·생성·배포·연결하는 CLI. 표준 라이브러리만 사용해 별도 의존성 없이 실행됩니다(YAML 검증 시에만 pyyaml).

설정

hasa login --base-url https://<gateway-host> --api-key <API_KEY>
hasa login --playground            # 키 없이 체험(플레이그라운드 허용 시)

설정은 ~/.hasa/config.json(권한 600)에 저장됩니다. 비밀 키는 환경변수 HASA_API_KEY로도 주입할 수 있습니다.

명령

명령	설명
hasa models list	서빙 중인 모델 목록
hasa templates list	기능 템플릿 목록
hasa templates show <id>	템플릿 상세(입출력·요구 모델)
hasa templates run <id> --input k=v	템플릿 직접 실행
hasa app validate <appspec>	AppSpec 스키마 + 참조 모델 검증
hasa app generate <appspec> -o <dir>	AppSpec → 표준 프로젝트 스캐폴딩
hasa app dev <dir>	생성 프로젝트 로컬 실행(핫리로드)
hasa app deploy <dir>	docker-compose 배포 산출물 생성
hasa connect claude\|cursor	코딩 에이전트용 MCP 연결 config 발급

생성 프로젝트 구조

hasa app generate는 생성 코드와 사용자 코드를 분리한 표준 프로젝트를 만듭니다.

my-app/
├─ appspec.yaml          # 진실원천 — 바꾸면 재생성
├─ AGENTS.md · CLAUDE.md · .cursor/rules/   # 코딩 에이전트 지침
├─ src/generated/        # 플랫폼 생성 코드 — 수정 금지(재생성 시 덮어써짐)
├─ src/extensions/       # 사용자·에이전트 코드 — 재생성해도 보존
└─ tests/

이 분리 덕분에 AppSpec을 바꿔 다시 생성해도 직접 작성한 업무 로직이 보존됩니다.

보안

• API 키는 설정 파일(권한 600) 또는 환경변수로만. 코드·커밋에 넣지 마세요.
• 게이트웨이 base_url은 배포 환경의 값을 사용하세요(https://<gateway-host>).

다음: 빠른 시작