서버 API

CLI-JAW는 15개의 라우트 모듈에 걸쳐 141개의 HTTP API 엔드포인트를 제공합니다. 모든 변경(mutation) 라우트는 인증이 필요합니다.

기본 URL

http://localhost:3457    # Single instance (jaw serve)
http://localhost:24576   # Dashboard (jaw dashboard)

인증

루프백 요청(127.0.0.1, localhost, ::1)은 자동으로 인증됩니다. 원격 요청은 GET /api/auth/token에서 발급받은 Bearer 토큰이 필요합니다.

라우트 모듈

모듈	라우트 수	설명
server.ts	14	부트스트랩, 상태 확인, WebSocket
settings.ts	18	설정, 프롬프트, 하트비트, MCP, CLI 레지스트리
memory.ts	13	메모리 런타임 + KV + 파일
browser.ts	41	CDP, web-ai, 탭, 디버그
jaw-memory.ts	11	Jaw 메모리 검색/읽기/저장
orchestrate.ts	11	PABCD 상태, 워커, 디스패치
goal.ts	3	Goal CRUD
goal-run.ts	3	제한된 목표 실행
messaging.ts	6	업로드, 음성, 채널 전송
employees.ts	5	Employee CRUD
skills.ts	5	스킬 목록/활성화/비활성화
avatar.ts	4	아바타 이미지
traces.ts	3	트레이스 조회
heartbeat.ts	2	하트비트 설정
i18n.ts	2	언어/로케일

주요 엔드포인트

채팅

메서드	경로	설명
POST	/api/chat	메시지 전송 (스트리밍 NDJSON 응답)
GET	/api/chat/history	채팅 기록 조회
POST	/api/chat/stop	생성 중단

목표

메서드	경로	설명
GET	/api/goal	활성 목표 조회
POST	/api/goal	목표 설정/업데이트/완료/취소
GET	/api/goal/history	목표 이력

오케스트레이션

메서드	경로	설명
GET	/api/orchestrate/state	현재 PABCD 상태
PUT	/api/orchestrate/state	상태 전환
POST	/api/orchestrate/reset	IDLE로 초기화
POST	/api/orchestrate/dispatch	워커 디스패치

설정

메서드	경로	설명
GET	/api/settings	설정 조회
PATCH	/api/settings	설정 업데이트
GET	/api/settings/prompt	시스템 프롬프트 조회

CLI Commands Configuration