레퍼런스

CLI 명령어

ima2 CLI는 로컬 서버 위의 얇은 셸이라 대부분의 명령은 실행 중인 ima2 serve가 필요합니다. 예외 — serve, setup, doctor, status, open, reset, config, grok, skill, capabilities, 로컬 defaults — 는 서버 없이도 동작합니다.

서버

명령	설명
`ima2 serve [--dev]`	로컬 웹 서버 시작; `--dev`는 상세 진단을 켭니다.
`ima2 setup` / `ima2 login`	저장된 인증 재설정(대화형).
`ima2 status`	설정과 OAuth 상태 표시.
`ima2 doctor`	Node·패키지·설정·인증 진단.
`ima2 doctor image-probe [--json]`	no-image 지원 번들용 라이브 sanitized Responses 이미지 프로브.
`ima2 open`	브라우저에서 웹 UI 열기.
`ima2 grok login/status/models/proxy`	`provider: "grok"`이 쓰는 번들 progrok 런타임 인증·상태 확인.
`ima2 reset`	저장된 설정 제거.

생성

명령	설명
`ima2 gen <prompt>`	CLI에서 생성.
`ima2 edit <file> --prompt <text>`	기존 이미지 편집.
`ima2 multimode <prompt>`	멀티 이미지 SSE 생성 (`phase` / `partial` / `image` 스트리밍).
`ima2 video <prompt>`	Grok을 통한 비디오 생성 (SSE 스트리밍, 진행률 표시).
`ima2 node generate`	Node 모드 생성 (SSE; `--no-stream` 지원).
`ima2 node show <nodeId>`	노드 메타데이터 읽기.

ima2 gen "a poster of a samurai cat" --model gpt-5.4 --provider api --reasoning-effort high
ima2 grok login
ima2 gen "a cinematic neon city" --provider grok --model grok-imagine-image-quality
ima2 video "고양이가 피아노 치는 영상" --duration 5 --resolution 720p
ima2 edit input.png --prompt "make it rainy" --provider oauth --web-search
ima2 multimode "two cats playing" --max-images 2 --ref cat.png --mode direct

에이전트 디스커버리

에이전트는 흩어진 도움말을 추측하지 말고 패키징된 skill·capability 명령에서 시작해야 합니다.

명령	설명
`ima2 skill [--json]`	패키징된 Markdown skill 출력(또는 JSON 래퍼).
`ima2 capabilities --json`	지원 명령, 모델/품질/reasoning 값, 권고 한도.
`ima2 defaults --json`	유효 모델/reasoning 기본값(서버 우선, 로컬 설정 폴백).

생성/기본값 선택에는 capabilities --json의 valid.imageModels.supported만 쓰세요. limits.maxParallel은 권고 큐 가이드이지 서버측 동시성 세마포어가 아닙니다.

히스토리 & 관측

명령	설명
`ima2 ls [--session <id>] [--favorites]`	최근 히스토리 목록; `--favorites`는 서버측 필터.
`ima2 show <name> [--metadata]`	생성 에셋 표시, 선택적으로 임베드 메타데이터.
`ima2 metadata <file>`	로컬 이미지의 임베드 메타데이터 읽기.
`ima2 inflight ls [--terminal]`	활성(선택적으로 종료) 작업을 phase / 모델 / 프롬프트와 함께 목록.
`ima2 ps` / `ima2 cancel <id>`	`inflight ls` / `inflight rm`의 별칭.
`ima2 ping`	실행 중인 서버 헬스 체크.

설정 & 기본값

명령	설명
`ima2 config get <key>`	유효 설정에서 점 표기 키 읽기(시크릿 마스킹).
`ima2 config set <key> <value>`	파일 레이어에 기록; 알 수 없는 키와 인증 키 거부.
`ima2 config keys [--json]`	쓰기 가능 키와 이를 오버라이드하는 env 변수 목록.
`ima2 defaults set model <model>`	두 프로바이더 경로 모두에 기본 이미지 모델 영속화.
`ima2 defaults set reasoning <effort>`	두 프로바이더 경로 모두에 기본 reasoning effort 영속화.

전체 레퍼런스. 대부분의 서버 라우트에 CLI 래퍼가 있습니다 — 세션, 그래프, 주석, canvas 버전, 프롬프트 라이브러리, 가져오기, Card News 모두 해당하지만, Agent 모드 (/api/agent/*)는 웹 UI 전용입니다. Prompt builder는 ima2 prompt build로 사용할 수 있습니다. 전체는 CLI.md를 보세요.

프로바이더 & 모델 설정