레퍼런스

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 video edit <prompt> --video <value>`	비디오-투-비디오 편집. HTTPS URL, xAI file_id, data URL, generated MP4 지원.
`ima2 video extend <prompt> --video <value>`	비디오 마지막 프레임에서 이어붙이기. extension duration은 2–10초.
`ima2 video frame <generated-file>`	generated MP4에서 PNG 프레임 추출.
`ima2 video analyze <generated-file>`	generated MP4의 첫/마지막 프레임 분석. 원격 URL은 거부.
`ima2 node generate`	Node 모드 생성 (SSE; `--no-stream` 지원).
`ima2 node show <nodeId>`	노드 메타데이터 읽기.

ima2 grok login은 manual-paste 로그인 흐름을 기본으로 씁니다.

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 video "이 장면을 애니메이트" --ref scene.png --planner-model grok-4.3 --storyboard
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 skill front`	프론트엔드 구현 스킬 출력 (`skills/ima2-front/SKILL.md`).
`ima2 skill uiux`	디자인 방향 탐색 스킬 출력 (`skills/ima2-uiux/SKILL.md`).
`ima2 skill ls`	사용 가능한 패키징 스킬 목록.
`ima2 skill [front\|uiux] path`	스킬 파일 경로 출력.
`ima2 skill [front\|uiux] refs`	레퍼런스 모듈 목록 (이름 + 라인 수).
`ima2 skill [front\|uiux] ref <name>`	레퍼런스 모듈 하나 출력 (예: `motion`, `design-isms`).
`ima2 skill [front\|uiux] --with-refs`	SKILL.md + 전체 레퍼런스 모듈 번들 출력.
`ima2 skill install --dir <path>`	에이전트의 스킬 디렉토리에 설치.
`ima2 skill install --tmp`	`$TMPDIR/ima2-skills/`에 설치 (임시 폴백).
`ima2 capabilities --json`	지원 명령, 모델/품질/reasoning 값, 권고 한도.
`ima2 defaults --json`	유효 모델/reasoning 기본값(서버 우선, 로컬 설정 폴백).

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

3개 패키징 스킬. ima2 skill (코어)은 CLI와 프롬프팅을 다룹니다. ima2 skill front는 프로덕션급 프론트엔드 엔지니어링(에셋 파이프라인, 모션/비디오, 반응형, 접근성, 안티슬롭, 28개 레퍼런스 파일)을 추가합니다. ima2 skill uiux는 디자인 방향 탐색(이미지 우선 ism 워크플로, UX 상태, 프로덕트 퍼스널리티, 18개 레퍼런스 파일)을 추가합니다.

히스토리 & 관측

명령	설명
`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를 보세요.

프로바이더 & 모델 설정