cli-anything-anygen은(는) 무엇을 하나요?
AnyGen OpenAPI용 상태 저장 명령줄 인터페이스 — 자연어 프롬프트로 전문적인 슬라이드, 문서, 웹사이트, 다이어그램 등을 생성합니다. AI 에이전트 및 고급 사용자를 위해 설계되었습니다.
설치
이 CLI는 cli-anything-anygen 패키지의 일부로 설치됩니다:
pip install cli-anything-anygen
사전 요구사항:
- Python 3.10+
- 시스템에 anygen이 설치되어 있어야 합니다
사용법
기본 명령어
# 도움말 보기
cli-anything-anygen --help
# 대화형 REPL 모드 시작
cli-anything-anygen
# 새 프로젝트 생성
cli-anything-anygen project new -o project.json
# JSON 출력으로 실행 (에이전트 소비용)
cli-anything-anygen --json project info -p project.json
REPL 모드
서브커맨드 없이 호출하면 CLI가 대화형 REPL 세션에 진입합니다:
cli-anything-anygen
# 탭 완성 및 히스토리를 지원하는 대화형 명령어 입력
명령어 그룹
Task
작업 관리 — 생성, 폴링, 다운로드 및 실행.
| 명령어 | 설명 |
|---|---|
create | 생성 작업 만들기 |
status | 작업 상태 조회 (비차단) |
poll | 작업 완료까지 폴링 (차단) |
download | 완료된 작업의 생성 파일 다운로드 |
thumbnail | 완료된 작업의 썸네일 이미지 다운로드 |
run | 전체 워크플로우: 생성, 폴링, 다운로드 |
list | 로컬 캐시된 작업 레코드 나열 |
prepare | 작업 생성 전 다중 턴 요구사항 분석 |
File
파일 작업 — 참조 파일 업로드.
| 명령어 | 설명 |
|---|---|
upload | file_token을 얻기 위해 참조 파일 업로드 |
Config
설정 관리 — API 키 및 설정.
| 명령어 | 설명 |
|---|---|
set | 설정 값 지정 |
get | 설정 값 조회 (또는 모두 표시) |
delete | 설정 값 삭제 |
path | 설정 파일 경로 표시 |
Session
세션 관리 — 히스토리, 실행 취소, 다시 실행.
| 명령어 | 설명 |
|---|---|
status | 세션 상태 표시 |
history | 명령어 히스토리 표시 |
undo | 마지막 명령어 실행 취소 |
redo | 마지막 취소 명령어 다시 실행 |
예제
새 프로젝트 생성
새 anygen 프로젝트 파일을 생성합니다.
cli-anything-anygen project new -o myproject.json
# 또는 프로그래매틱 사용을 위해 JSON 출력 사용
cli-anything-anygen --json project new -o myproject.json
대화형 REPL 세션
undo/redo를 지원하는 대화형 세션을 시작합니다.
cli-anything-anygen
# 대화형으로 명령어 입력
# 사용 가능한 명령어를 보려면 'help' 사용
# 히스토리 탐색을 위해 'undo' 및 'redo' 사용
상태 관리
CLI는 다음을 통해 세션 상태를 유지합니다:
- 실행 취소/다시 실행: 최대 50단계 히스토리
- 프로젝트 지속성: JSON으로 프로젝트 상태 저장/로드
- 세션 추적: 수정 및 변경 사항 추적
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽기 쉬운 (기본값): 테이블, 색상, 서식 지정 텍스트
- 기계가 읽기 쉬운 (
--json플래그): 에이전트 소비를 위한 구조화된 JSON
# 사람 대상 출력
cli-anything-anygen project info -p project.json
# 에이전트 대상 JSON 출력
cli-anything-anygen --json project info -p project.json
AI 에이전트용
이 CLI를 프로그래매틱하게 사용할 때:
- 항상
--json플래그를 사용하여 파싱 가능한 출력を得る - 반환 코드 확인 - 0은 성공, 0이 아니면 오류
- stderr 파싱 - 실패 시 오류 메시지 확인
- 파일 작업에는 절대 경로 사용
- 내보내기 작업 후 출력 존재 여부 확인
추가 정보
- 전체 문서: 패키지 내 README.md 참조
- 테스트 범위: 패키지 내 TEST.md 참조
- 방법론: cli-anything-plugin 내 HARNESS.md 참조
버전
1.0.0