cli-anything-seaclip은(는) 무엇을 하나요?
SeaClip-Lite 프로젝트 관리를 위한 무상태 명령줄 인터페이스입니다. HTTP API 및 직접 SQLite 읽기를 통해 통신합니다. 로컬 상태나 세션을 유지하지 않습니다.
설치
pip install -e .
전제 조건:
- Python 3.10+
- localhost:5200에서 실행 중인 SeaClip-Lite 백엔드
사용법
기본 명령어
# 도움말 표시
cli-anything-seaclip --help
# 대화형 REPL 모드 시작
cli-anything-seaclip
# JSON 출력으로 실행 (에이전트 소비용)
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list
REPL 모드
하위 명령어 없이 호출하면 CLI가 대화형 REPL 세션을 시작합니다:
cli-anything-seaclip
# 탭 완성 및 히스토리와 함께 명령어를 대화형으로 입력
명령어 그룹
Issue
이슈 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
list | 이슈 목록 조회 (--status, --priority, --search, --limit) |
create | 새 이슈 생성 (--title, --description, --priority) |
move | 이슈를 컬럼으로 이동 (ISSUE_ID --column COL) |
status | 이슈 상태 업데이트 (ISSUE_ID --set STATUS) |
delete | 이슈 삭제 (ISSUE_ID) |
Agent
파이프라인 에이전트 명령어입니다.
| 명령어 | 설명 |
|---|---|
list | 모든 파이프라인 에이전트 목록 조회 |
Pipeline
파이프라인 제어 명령어입니다.
| 명령어 | 설명 |
|---|---|
start | 파이프라인 시작 (--issue UUID --mode auto/manual) |
status | 파이프라인 상태 조회 (--issue UUID) |
resume | 일시 중지된 파이프라인 재개 (--issue UUID) |
stop | 실행 중인 파이프라인 중지 (--issue UUID) |
Scheduler
일정 구성 명령어입니다.
| 명령어 | 설명 |
|---|---|
list | 모든 일정 구성 목록 조회 |
add | 일정 추가 (--name, --cron, --repo) |
sync | 동기화 트리거 (SCHEDULE_ID) |
Activity
활동 피드 명령어입니다.
| 명령어 | 설명 |
|---|---|
list | 최근 활동 조회 (--limit N) |
Server
서버 유틸리티 명령어입니다.
| 명령어 | 설명 |
|---|---|
health | 백엔드 상태 확인 |
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽을 수 있는 형식 (기본값): 표, 색상, 형식화된 텍스트
- 기계 판독 가능 형식 (
--json플래그): 에이전트 소비를 위한 구조화된 JSON
# 사람용 출력
cli-anything-seaclip issue list
# 에이전트용 JSON 출력
cli-anything-seaclip --json issue list
AI 에이전트를 위한 안내
이 CLI를 프로그래매틱하게 사용할 때:
- 항상
--json플래그를 사용하여 파싱 가능한 출력을 얻으세요. - 반환 코드를 확인하세요 – 0은 성공, 0이 아니면 오류입니다.
- stderr를 파싱하여 실패 시 오류 메시지를 확인하세요.
- 오류 응답은 JSON 모드에서
{"error": "message"}형식으로 제공됩니다.
버전
1.0.0