Session Commands

세션 명령어는 현재 CLI-JAW 대화를 관리합니다: 도움말 보기, 명령어 탐색, 상태 확인, 히스토리 삭제, 컨텍스트 압축, 상태 초기화, 대화 중 에이전트 방향 전환 등을 수행합니다. 대화형 사용 중에 가장 자주 사용하게 되는 명령어들입니다.

모든 세션 명령어는 /로 시작하며 채팅 입력창에서 직접 입력할 수 있습니다. 자연어로도 실행할 수 있습니다 — CLI-JAW는 한국어와 영어를 동일하게 이해합니다. 각 명령어 아래의 "~해줘" 팁을 참고하세요.

빠른 참조

명령어설명
/help [command]전체 명령어 또는 특정 명령어의 도움말 표시
/commands퍼지 검색이 가능한 명령어 팔레트 열기
/status현재 세션 상태 및 진단 정보 표시
/clear [all]대화 삭제 / all: 스킬+직원+MCP 리셋
/purge대화 + 메모리 삭제
/compact [instructions]핵심 정보를 유지하면서 컨텍스트 압축
/reset [confirm]부트스트랩 초기화 — 대화, 메모리, 스킬, 직원, MCP 모두 삭제
/steer <prompt>대화 중 에이전트를 새로운 방향으로 전환

명령어 상세 설명

/help

/help [command]

CLI-JAW 명령어에 대한 문서를 표시합니다. 인수 없이 호출하면 카테고리별로 그룹화된 모든 사용 가능한 명령어를 나열합니다. 명령어 이름을 제공하면 해당 명령어의 상세 사용법, 인수, 예제를 표시합니다.

인수:

인수필수설명
command아니오상세 도움말을 볼 특정 명령어 이름 (/ 접두사 제외)
# 모든 명령어 나열
/help

# 특정 명령어의 상세 도움말 보기
/help compact

# steer 명령어 도움말
/help steer
"~해줘" tip: "도움말 보여줘", "명령어 뭐 있어?", "compact 사용법 알려줘" 모두 /help에 매핑됩니다. CLI-JAW가 의도를 감지하고 관련 문서를 표시합니다.

/commands

/commands

명령어 팔레트를 엽니다 — 사용 가능한 모든 슬래시 명령어를 검색할 수 있는 인터랙티브 목록입니다. 팔레트는 퍼지 매칭을 지원하므로 부분적인 이름만 입력해도 원하는 명령어를 빠르게 찾을 수 있습니다. 아직 사용해보지 않은 명령어를 발견하는 가장 빠른 방법입니다.

팔레트는 각 명령어의 카테고리, 간단한 설명, 키보드 단축키(있는 경우)를 표시합니다. 명령어를 선택하면 즉시 실행하거나 추가 편집을 위해 입력창에 삽입할 수 있습니다.

# 명령어 팔레트 열기
/commands

# 팔레트에서 입력하여 필터링:
# "mod" → /model, /model-list 표시
# "sk" → /skill, /skill load, /skill list 표시
"~해줘" tip: "명령어 팔레트 열어줘", "커맨드 목록 보여줘"로 명령어 팔레트를 실행할 수 있습니다. "뭐 할 수 있어?"라고 말하면 기능에 대한 대화형 개요를 볼 수도 있습니다.

/status

/status

현재 세션의 종합적인 스냅샷을 표시합니다. 활성 모델 및 CLI 백엔드, 로드된 스킬, 대화 토큰 수, 메모리 사용량, 활성 목표, 연결된 통합 서비스(Telegram, Discord 등), 서버 상태를 포함합니다. 에이전트가 특정 방식으로 동작하는 이유를 디버깅하거나 파악할 때 유용합니다.

상태 필드:

필드설명
Model현재 활성화된 LLM (예: claude-opus-4-8, gpt-5.5)
CLI활성 CLI 백엔드 (Claude Code, Codex 등)
Skills현재 로드된 스킬 목록 및 활성/비활성 상태
Tokens현재 컨텍스트 윈도우 사용량 (사용량 / 최대)
Goals활성 목표 및 완료 상태
Integrations연결된 서비스 (Telegram, Discord, Electron)
Memory메모리 인덱스 크기 및 마지막 동기화 시간
Uptime현재 세션의 실행 시간
# 현재 세션 상태 확인
/status

# 출력 예시:
# Model: claude-opus-4-8 via Claude Code
# Skills: dev (active), github (active), memory (active) + 7 more
# Tokens: 42,318 / 200,000 (21%)
# Goals: 2 active, 1 completed
# Uptime: 1h 23m
"~해줘" tip: "지금 상태 보여줘", "현재 세션 정보", "토큰 얼마나 썼어?" 모두 /status로 연결됩니다. 에이전트가 읽기 쉬운 형식으로 상태를 표시합니다.

/clear

/clear [all]

현재 세션의 대화 히스토리를 삭제합니다. 스킬, 메모리, 세션 설정은 그대로 유지됩니다.

all 인자를 추가하면 스킬 초기화, 직원 리셋, MCP 동기화, 세션 상태 초기화까지 수행합니다. 메모리는 보존됩니다.

초기화 단계 (가벼움 → 무거움):

명령어대화스킬/직원/MCP메모리
/clear✅ 삭제보존보존
/clear all✅ 삭제✅ 리셋보존
/purge✅ 삭제보존✅ 삭제
/reset confirm✅ 삭제✅ 하드 리셋✅ 삭제
# 대화만 삭제
/clear

# 스킬, 직원, MCP, 세션까지 리셋 (메모리는 유지)
/clear all
"~해줘" tip: "대화 초기화해줘", "히스토리 지워줘" → /clear. "스킬까지 초기화해줘" → /clear all.

/purge

/purge

대화 히스토리와 구조화된 메모리(memory/structured/)를 모두 삭제합니다. 스킬, 직원, 설정은 보존됩니다. 에이전트가 이 인스턴스에서 학습한 모든 것을 잊게 하되, 도구와 연동은 유지하고 싶을 때 사용합니다.

# 대화 + 메모리 삭제, 스킬은 유지
/purge
"~해줘" tip: "메모리까지 지워줘", "기억 다 삭제해줘", "대화랑 메모리 초기화" → /purge.

/compact

/compact [instructions]

이전 대화를 요약하여 현재 대화 컨텍스트를 압축하면서 핵심 결정 사항, 코드 변경, 중요한 맥락은 보존합니다. 컨텍스트 윈도우 한계에 다가가는 긴 세션에서 대화의 흐름을 완전히 잃지 않으면서 공간을 확보하고 싶을 때 필수적인 명령어입니다.

에이전트가 전체 대화를 읽고 핵심 정보(내린 결정, 수정된 파일, 발생한 오류, 진행 중인 목표)를 식별한 뒤, 전체 히스토리를 대체하는 밀도 높은 요약을 생성합니다. 선택적으로 요약이 어디에 중점을 두어야 하는지 안내하는 지시사항을 전달할 수 있습니다.

인수:

인수필수설명
instructions아니오요약에서 우선시할 내용에 대한 자연어 안내 (예: "API 결정 사항 유지", "인증 흐름에 집중")
# 기본 컨텍스트 압축
/compact

# 특정 내용에 집중하여 압축
/compact keep the database schema decisions and migration plan

# 오류와 수정 사항에 집중하여 압축
/compact focus on the bugs we found and how we fixed them

# 한국어 지시사항도 가능
/compact API 설계 결정사항만 유지해줘
"~해줘" tip: "컨텍스트 줄여줘", "대화 요약해줘", "컨텍스트 압축해줘", "토큰 아껴줘" 모두 /compact에 매핑됩니다. 토큰 사용량이 60-70%를 넘기기 시작하면 가장 유용한 명령어입니다.

/reset

/reset [confirm]

전체 부트스트랩 초기화를 수행합니다 — 가장 과격한 초기화 옵션입니다. 대화 히스토리, 구조화된 메모리, 스킬(하드 리셋), 직원, MCP를 모두 삭제합니다. settings.json(서버 설정, 인증 토큰, CLI 구독 정보)만 보존됩니다.

파괴적인 작업이므로 confirm 인자가 필수입니다.

인수:

인수필수설명
confirm필수. 없으면 확인 안내를 표시합니다.

삭제 vs. 보존:

삭제됨 (부트스트랩 리셋)보존됨
대화 히스토리settings.json (포트, 토큰, 구독)
구조화된 메모리 (memory/structured/)
모든 설치된 스킬 (하드 리셋)
직원 설정
MCP 상태
# 확인 안내 표시
/reset

# 부트스트랩 초기화 즉시 실행
/reset confirm

# 인스턴스가 심하게 꼬였을 때 처음부터 시작
/reset confirm
"처음부터 다시 설정하자"
"~해줘" tip: "완전히 초기화해줘", "공장 초기화해줘", "부트스트랩 리셋해줘" → /reset confirm. 더 가벼운 초기화는 /clear, /clear all, /purge를 사용하세요.

/steer

/steer <prompt>

히스토리를 삭제하지 않고 대화 중에 에이전트의 방향을 전환합니다. 에이전트가 잘못된 방향으로 가고 있거나 기존 컨텍스트를 유지하면서 다른 접근 방식으로 전환하고 싶을 때 사용합니다. steer 프롬프트는 에이전트의 현재 경로를 재정의하는 높은 우선순위의 시스템 수준 지시사항으로 주입됩니다.

/clear보다 정밀한 명령어입니다 — 전체 대화 히스토리와 컨텍스트를 유지하면서 에이전트가 새로운 방향에 따라 접근 방식을 재평가합니다. 방향 수정에 이상적입니다: "X를 그만하고 대신 Y를 해라."

인수:

인수필수설명
prompt새로운 방향, 접근 방식 또는 제약 조건을 설명하는 자연어 지시사항
# 접근 방식 변경
/steer stop using class components, use hooks instead

# 언어/프레임워크 변경
/steer switch to TypeScript for all new files

# 동작 조정
/steer be more concise, skip explanations, just show code

# 한국어도 자연스럽게 동작
/steer 설명 생략하고 코드만 보여줘

# 작업 방향 전환
/steer 이 방식 말고 WebSocket으로 구현하자
"~해줘" tip: "방향 바꿔줘", "다른 방법으로 해줘", "이렇게 말고 저렇게 해", "접근 방식 바꿔" 모두 steering 동작을 호출합니다. 새로운 방향을 자연스럽게 말해도 에이전트가 전환을 감지합니다. /steer는 이를 명시적이고 강력하게 만듭니다.

어떤 명령어를 사용해야 할까

적절한 세션 명령어를 선택하는 것은 얼마나 많은 상태를 보존하고 싶은지에 달려 있습니다:

상황명령어이유
대화가 너무 길어져 토큰 한계에 다가가는 경우/compact토큰을 확보하면서 핵심 결정 사항을 보존
현재 주제를 마무리하고 새 작업을 시작하는 경우/clear같은 작업 공간 상태에서 새로운 대화
에이전트가 잘못된 방향으로 가고 있는 경우/steer컨텍스트를 잃지 않고 방향 수정
세션이 심하게 혼란스럽거나 손상된 경우/reset최후의 수단 — 전체 재시작
명령어 이름이 기억나지 않는 경우/commands사용 가능한 모든 명령어를 검색할 수 있는 팔레트
토큰 사용량이나 로드된 스킬을 확인해야 하는 경우/status세션 진단 정보를 한눈에 확인
CLI-JAW를 처음 사용하며 기능을 탐색하는 경우/help채팅에 내장된 문서

명령어 생명주기

세션 명령어는 CLI-JAW 스택의 서로 다른 수준에서 동작합니다:

자연어는 항상 동작합니다. 슬래시 명령어를 굳이 기억할 필요가 없습니다. "대화 지워줘"라고 말하는 것은 /clear를 입력하는 것과 동일합니다. 슬래시 명령어는 정확성과 속도를 위해 존재하지만, CLI-JAW의 의도 감지가 나머지를 처리합니다.