Root CLI 서브커맨드

CLI-JAW 서버를 포그라운드에서 시작합니다. chat, dispatch, browser 및 대부분의 다른 명령이 작동하려면 서버가 먼저 실행 중이어야 합니다.

jaw serve [--port <N>] [--no-open] [--lan] [--remote]

예제

# 기본값으로 시작 (포트 3457, 브라우저 자동 열기)
jaw serve

# 커스텀 포트, 브라우저 열기 비활성화
jaw serve --port 3458 --no-open

# 로컬 네트워크 접근을 위한 LAN 모드
jaw serve --lan --port 3460

# 별도의 데이터 디렉토리 사용
jaw --home ~/.cli-jaw-work serve --port 3458

멀티 인스턴스 관리자입니다. 대시보드 서버를 시작하고, 인스턴스를 조회/시작/중지하며, 영구 서비스를 관리하고, L2 크로스 인스턴스 메모리 페더레이션 검색을 수행합니다.

jaw dashboard <command> [options] [--json]

예제

# 대시보드 시작
jaw dashboard serve

# 온라인 인스턴스를 JSON으로 조회
jaw dashboard ls --json | jq '.[] | select(.status == "online")'

# 포트 3458에 새 인스턴스 시작
jaw dashboard start 3458 --home ~/.jaw-work

# 인스턴스 중지
jaw dashboard stop 3457

# 크로스 인스턴스 메모리 검색
jaw dashboard memory search "JWT authentication"

# 모든 메모리 인스턴스 조회
jaw dashboard memory instances

# 영구 자동 시작 등록
jaw dashboard perm 3458 --home ~/.jaw-work

API 핑을 통해 jaw 서버가 실행 중인지 확인합니다. 선택적으로 대시보드 서버도 함께 확인할 수 있습니다.

jaw status [--port <N>] [--json] [--dashboard]

종료 코드 0 = 서버 실행 중, 1 = 서버 미실행 또는 오류.

예제

# 빠른 상태 확인
jaw status

# 스크립팅용 JSON 출력
jaw status --json
# → {"status":"running","port":"3457","cli":"claude"}

# 서버와 대시보드 모두 확인
jaw status --dashboard

# 특정 포트 확인
jaw status --port 3458

최초 설정을 위한 대화형 설정 마법사입니다. ~/.cli-jaw/settings.json을 생성하고, 기본 CLI 백엔드, 메시징 채널, 스킬 디렉토리를 구성합니다.

jaw init [options]

예제

# 대화형 마법사 (첫 실행 시 권장)
jaw init

# 기본값으로 비대화형 실행
jaw init --non-interactive --cli claude

# 강제 재초기화
jaw init --force --cli gemini --channel telegram

# 실제 변경 없이 미리보기
jaw init --dry-run

설치 및 구성 상태를 진단합니다. Node.js 버전, CLI 바이너리 해석, 설정 파일 유효성, MCP 서버 연결, 직원 CLI 가용성, 포트 가용성을 검사합니다.

jaw doctor [--json] [--fix] [--tcc] [--prime]

예제

# 진단 실행
jaw doctor

# 기계 판독 가능한 출력
jaw doctor --json

# 감지된 문제 자동 수정
jaw doctor --fix

# macOS 접근성 권한 확인
jaw doctor --tcc

공장 초기화: MCP 동기화, 스킬 초기화, 직원 초기화, 세션 클리어를 수행합니다. --yes를 전달하지 않으면 확인을 요청합니다. 실행 중인 서버가 필요합니다.

jaw reset [--yes] [--port <N>]

예제

# 확인 프롬프트와 함께 초기화
jaw reset

# 확인 건너뛰기 (스크립팅용)
jaw reset --yes

# 특정 인스턴스 초기화
jaw reset --port 3458 --yes

대화형 터미널 REPL입니다. SSE-first TUI 채널로 실행 중인 서버에 연결하고, 오래된 서버에서는 legacy WebSocket fallback을 사용합니다. 영구 푸터가 있는 리치 TUI 모드, UI 통합을 위한 원시 JSON 프로토콜 모드, 최소한의 일반 readline 모드를 지원합니다.

jaw chat [--port <N>] [--raw] [--simple]

예제

# 기본 리치 TUI
jaw chat

# 심플 모드 (단순 터미널에서 동작)
jaw chat --simple

# 다른 인스턴스에 연결
jaw chat --port 3458

# 파이프를 위한 원시 JSON 모드
jaw chat --raw

직원 에이전트에게 작업을 전송합니다. 직원은 서버 API를 통해 비동기적으로 실행되며, 결과를 stdout으로 반환합니다. 스크립팅 워크플로우에서 파이프와 호환됩니다. JAW_BOSS_TOKEN이 필요합니다 (서버 프로세스에서 상속).

jaw dispatch --agent <name> --task <text> [--json] [--port <N>]

예제

# 프론트엔드 작업 디스패치
jaw dispatch --agent "Frontend" --task "Fix CSS bug in the header component"

# 백엔드 작업 디스패치
jaw dispatch --agent "Backend" --task "Add rate limiting to /api/chat endpoint"

# 파이프를 위한 JSON 출력
jaw dispatch --agent "Data" --task "Optimize the slow query in reports" --json

직원 관리 유틸리티입니다. 현재 직원을 기본 5개 프로필(Frontend, Backend, Data, Docs, QA)로 초기화하는 기능을 지원합니다.

jaw employee <subcommand> [--port <N>]

예제

# 모든 직원을 기본값으로 초기화
jaw employee reset

# 특정 인스턴스에서 초기화
jaw employee reset --port 3458

PABCD 상태 머신 전환입니다. Interview, Planning, Audit, Build, Check, Done 단계를 거쳐 워크플로우를 진행합니다. 실행 중인 서버의 API를 호출하므로 SSE-first 이벤트 업데이트가 연결된 클라이언트에 실시간으로 전달됩니다.

jaw orchestrate <phase> [--force] [--json] [--port <N>]

유효한 전환: IDLE → I → P → A → B → C → D → IDLE. Interview는 선택 사항이며 IDLE → P도 유효합니다.

예제

# 플래닝 단계 시작
jaw orchestrate P

# 강제 전환 (유효성 검사 건너뛰기)
jaw orchestrate B --force

# 현재 상태 확인
jaw orchestrate status

# IDLE로 초기화
jaw orchestrate reset

# JSON 출력
jaw orchestrate status --json

영구 목표 라이프사이클 관리입니다. 목표를 설정하고, 체크포인트로 진행 상황을 추적하며, 목표 상태(일시정지, 재개, 취소, 완료)를 관리합니다. 목표는 세션과 서버 재시작을 넘어 유지됩니다.

jaw goal <subcommand> [args...] [--port <N>]

예제

# 새 목표 설정
jaw goal set "Implement keyboard shortcuts for the editor"

# 현재 목표 확인
jaw goal status

# 진행 체크포인트 추가
jaw goal update "K0: shortcut registry done, K1: in progress"

# 완료 처리
jaw goal done "All phases complete, PR merged"

# 과거 목표 조회
jaw goal history 5

# 일시정지 및 재개
jaw goal pause
jaw goal resume

# 사유와 함께 취소
jaw goal cancel "Deprioritized in favor of auth refactor"

영구 메모리 저장소 CLI입니다. 메모리 파일을 검색, 읽기, 저장, 목록 조회할 수 있습니다. 메모리는 ~/.cli-jaw/memory/에 마크다운 파일로 저장되며 시맨틱 검색을 위해 인덱싱됩니다.

jaw memory <subcommand> [args...]

예제

# 메모리 검색
jaw memory search "JWT authentication patterns"

# 특정 파일 읽기
jaw memory read structured/profile.md

# 새 메모리 항목 저장
jaw memory save structured/profile.md "- User prefers concise Korean summaries"

# 에피소드 로그 저장
jaw memory save structured/episodes/live/2026-05-29.md "## 14:30\n- Completed CLI docs page"

# 모든 파일 목록 조회
jaw memory list

CDP(Chrome DevTools Protocol)를 통한 Chrome 브라우저 제어입니다. 페이지 열기, 스크린샷 촬영, 요소 클릭, 텍스트 입력, 탭 관리, Web AI 기반 브라우징을 수행합니다. 서버가 실행 중이어야 합니다.

jaw browser <subcommand> [args...]

예제

# 브라우저 상태 확인
jaw browser status

# 페이지 열기 및 스크린샷 촬영
jaw browser open https://example.com
jaw browser screenshot

# 요소 ref를 위한 페이지 스냅샷 가져오기
jaw browser snapshot

# ref를 사용한 클릭 및 입력
jaw browser click ref:42
jaw browser type ref:15 "search query"

# 적응형 페치
jaw browser fetch https://example.com/api/data

스킬 관리: 설치된 스킬 목록 조회, reference/Codex/GitHub에서 설치, 스킬 제거, 스킬 상세 정보 조회를 수행합니다. 스킬은 에이전트의 시스템 프롬프트에 주입됩니다.

jaw skill [subcommand] [name...]

예제

# 설치된 스킬 목록 조회
jaw skill

# 스킬 설치
jaw skill install cloudflare
jaw skill install docker kubernetes terraform

# 스킬 제거
jaw skill remove cloudflare

# 스킬 상세 정보 조회
jaw skill info dev-frontend

# 기본값으로 초기화
jaw skill reset

MCP (Model Context Protocol) 서버 관리입니다. npm/PyPI MCP 패키지를 설치하고, 6개 CLI 백엔드 전체에 구성을 동기화하며, 등록된 서버를 조회하거나 기본값으로 초기화합니다.

jaw mcp [subcommand] [package]

패키지 에코시스템은 자동 감지됩니다: @scope/name은 npm, mcp-server-*는 PyPI입니다. --pypi 또는 --npm으로 수동 지정할 수 있습니다.

예제

# 모든 MCP 서버 목록 조회
jaw mcp

# npm MCP 패키지 설치
jaw mcp install @anthropic/mcp-server-fetch

# PyPI MCP 패키지 설치
jaw mcp install mcp-server-git

# 모든 CLI에 구성 동기화
jaw mcp sync

# 기본 MCP 서버로 초기화
jaw mcp reset --force

대시보드 커넥터 CLI -- 칸반 보드, 노트, 리마인더, 감사 로그를 위한 통합 진입점입니다. 웹 UI 없이 대시보드 기능에 직접 CLI로 접근할 수 있습니다.

jaw connector <surface> <subcommand> [options]

예제

# 칸반 태스크 추가
jaw connector board add --title "Implement auth flow" --lane backlog

# 태스크를 done으로 이동
jaw connector board update task-id-123 --lane done

# 보드 태스크 목록 조회
jaw connector board list --json

# 노트 작성
jaw connector notes write --path "meeting/standup.md" --body "# Standup Notes\n- Auth PR merged"

# 노트 목록 조회
jaw connector notes list

# 리마인더 추가
jaw connector reminders add --title "Review PR #42" --priority high --due 2026-06-01

아이젠하워 매트릭스 스타일의 우선순위 기반 리마인더입니다. jaw connector reminders의 단축 명령입니다.

jaw reminders <subcommand> [options]

예제

# 리마인더 목록 조회
jaw reminders list

# 리마인더 추가
jaw reminders add "Review PR #42" --priority high --due 2026-06-01

# 메모와 함께 추가
jaw reminders add --title "Deploy staging" --notes "After QA sign-off" --priority normal

# 완료 처리
jaw reminders done reminder-id-abc

# JSON 출력
jaw reminders list --json

프로젝트 워크스페이스 디렉토리를 관리합니다. 에이전트가 활성 프로젝트 루트로 인식할 디렉토리를 설정합니다. 변경 사항은 서버 API를 통해 적용되며 세션 간에 유지됩니다.

jaw project <subcommand> [paths...]

예제

# 프로젝트 디렉토리 설정
jaw project set ~/Dev/frontend, ~/Dev/backend

# 단일 절대 경로 설정
jaw project set /Users/jun/projects/my-app

# 현재 디렉토리 목록 조회
jaw project list

# 전체 클리어
jaw project reset

크로스 플랫폼 자동 시작 관리입니다. OS를 감지하여 서버를 백그라운드 데몬으로 설치합니다 (macOS의 launchd, Linux의 systemd, 컨테이너의 Docker 엔트리포인트). 한 번의 명령으로 설치와 시작을 동시에 수행합니다.

jaw service [subcommand] [--port <N>] [--backend <type>]

예제

# 한 번에 설치 + 시작 (OS 자동 감지)
jaw service

# 커스텀 포트
jaw service --port 3458

# 서비스 상태 확인
jaw service status

# 로그 조회
jaw service logs

# 서비스 제거
jaw service unset

# 특정 백엔드 강제 지정
jaw service --backend systemd --port 3457

현재 구성을 복제하여 독립적인 에이전트 인스턴스를 생성합니다. 구성과 스킬을 복사하고, 새 데이터베이스를 생성하며, AGENTS.md를 재생성합니다. 여러 격리된 에이전트를 실행할 때 유용합니다.

jaw clone <target-dir> [--from <source>] [--with-memory] [--link-ref]

예제

# 새 디렉토리로 복제
jaw clone ~/.cli-jaw-work

# 메모리와 함께 복제
jaw clone ~/.cli-jaw-research --with-memory

# 특정 소스에서 복제
jaw clone ~/.cli-jaw-staging --from ~/.cli-jaw-prod

# 디스크 절약을 위해 참조 스킬 심볼릭 링크
jaw clone ~/.cli-jaw-dev --link-ref

macOS 전용 LaunchAgent 관리입니다 (지원 중단 -- 대신 jaw service를 사용하세요). 로그인 시 자동 시작을 위한 plist 파일을 관리합니다. 하위 호환성을 위해 유지됩니다.

jaw launchd [subcommand] [--port <N>]

예제

# 한 번에 설치 + 시작
jaw launchd

# 커스텀 포트
jaw launchd --port 3458

# 상태 확인
jaw launchd status

# 제거
jaw launchd unset

# 레거시 plist 정리
jaw launchd cleanup