cc-navi-lapal

cc-navi-lapal

Claude Code Context Navigator - 여러 Claude Code 세션에서 지금 어디서 작업 중인지 한눈에 구분할 수 있는 statusline 플러그인.

출력 예시

Standard (기본):

📁 playground  🌿 feature/auth  ↑2 ↓3 main │ 🤖 Opus 4.6 Max  💰 $0.42  ▰▰▰▰▱ 78%

Full:

📁 playground  🌿 feature/auth  ↑2 ↓3 main  🌳 WT │ ±3 │ 🤖 Opus 4.6 Max  📊 15k/4k  ⏱ 1h23m  💰 $0.42  ▰▰▰▰▱ 78%

Minimal:

📁 playground  🌿 feature/auth  ↑2 ↓3 main │ 🤖 Opus 4.6 Max  ▰▰▰▰▱ 78%

main 브랜치 작업 시:

 ON MAIN  │ 📁 playground  🌿 main  ✓ synced │ 🤖 Sonnet 4.5 API  💰 $0.18  ▰▰▱▱▱ 34%

주요 기능

• 프로젝트/브랜치 표시 — 어떤 프로젝트의 어떤 브랜치인지 즉시 확인
• Main 브랜치 관계 — ↑2 ↓3 main ahead/behind, ✓ main 동기화 상태
• 모델 상세 표시 — Opus 4.6 Max / Sonnet 4.5 API / Haiku 4.5 Bedrock
• Main 브랜치 경고 — ANSI 빨간 배경 ON MAIN 위험 알림
• Stale 브랜치 감지 — 24시간+ 미커밋 경고 (노란 텍스트)
• Worktree 지원 — 원본 프로젝트명 자동 감지, 동일 탭 색상 유지
• 프리셋 — minimal / standard / full 정보량 선택
• 그룹 세퍼레이터 — 위치 │ 상태 │ 세션 시각적 구분
• 컨텍스트 사용량 — ▰▰▰▰▱ 78% 컴팩트 바 (80%+ 노랑, 90%+ 빨강)
• 이모지 토글 — CC_NAVI_EMOJI=false로 텍스트 전용 모드
• iTerm2 연동 — 탭 색상, 뱃지(크기 조절), 타이틀 자동 설정

설치

# 설치 없이 바로 사용
npx cc-navi-lapal

# 글로벌 설치
npm i -g cc-navi-lapal

Claude Code 설정

~/.claude/settings.json에 추가:

{
  "statusLine": {
    "type": "command",
    "command": "npx cc-navi-lapal"
  }
}

프리셋

프리셋	모듈	용도
minimal	project, branch, mainRelation, model, contextBar	깔끔한 최소 정보
standard	+ worktree, alerts, cost	일반 사용 (기본값)
full	+ lastCommit, tokens, timer	모든 정보 표시

프리셋 변경:

# 환경변수
CC_NAVI_PRESET=minimal npx cc-navi-lapal

# CLI 옵션
npx cc-navi-lapal --preset full

# 설정 파일 (~/.cc-navi.json)
{ "preset": "full" }

설정

환경변수

변수	설명	예시
CC_NAVI_PRESET	프리셋 선택	minimal, standard, full
CC_NAVI_MODULES	개별 모듈 지정 (프리셋 무시)	project,branch,model
CC_NAVI_ITERM2	iTerm2 기능 비활성화	false
CC_NAVI_EMOJI	이모지 비활성화	false

우선순위: CLI 옵션 > 환경변수 > 설정 파일 > 기본값

설정 파일 (~/.cc-navi.json)

{
  "preset": "standard",
  "modules": {
    "tokens": true
  },
  "alerts": {
    "staleBranchHours": 24,
    "warnOnMain": true
  },
  "iterm2": {
    "tabColor": true,
    "badge": true,
    "badgeStyle": "compact",
    "badgeMaxWidth": 25,
    "badgeMaxHeight": 15,
    "tabTitle": true
  },
  "emoji": true
}

개별 modules 설정은 프리셋 위에 오버라이드됩니다.

CLI 옵션

npx cc-navi-lapal --preset minimal    # 프리셋 선택
npx cc-navi-lapal --list-modules      # 사용 가능한 모듈/프리셋 목록

모듈 설명

모듈	출력 예시	설명
project	📁 playground	프로젝트 이름 (worktree시 원본명)
branch	🌿 feature/auth	현재 브랜치
mainRelation	↑2 ↓3 main / ✓ main	main 대비 ahead/behind 또는 동기화 상태
worktree	🌳 WT	git worktree 여부
alerts	ON MAIN / ⚠ stale 2d / ±3	안전 경고 (ANSI 색상)
lastCommit	📝 3h ago	마지막 커밋 시간
model	🤖 Opus 4.6 Max	모델명 + 버전 + provider
tokens	📊 15k/4k	input/output 토큰 사용량
timer	⏱ 1h23m	세션 소요 시간
cost	💰 $0.42	세션 비용
contextBar	▰▰▰▰▱ 78%	컨텍스트 윈도우 사용량

Worktree 지원

worktree에서 작업 시 git rev-parse --git-common-dir로 원본 프로젝트명을 자동 감지합니다. 원본 repo와 worktree가 동일한 iTerm2 탭 색상을 공유합니다.

모델 감지

모델 ID	표시
claude-opus-4-6	Opus 4.6
claude-sonnet-4-5-20250929	Sonnet 4.5
claude-haiku-4-5-20251001	Haiku 4.5

Provider 감지

조건	Provider
CLAUDE_CODE_USE_BEDROCK=1	Bedrock
CLAUDE_CODE_USE_VERTEX=1	Vertex
ANTHROPIC_API_KEY 설정됨	API
위 모두 없음	Max

iTerm2 뱃지 설정

{
  "iterm2": {
    "badgeStyle": "compact",
    "badgeMaxWidth": 25,
    "badgeMaxHeight": 15
  }
}

스타일	예시	설명
full	playground + feature/auth	전체 이름
compact	play + ft/auth	축약 (기본값)
minimal	play	프로젝트명만

브랜치 축약 매핑: feature→ft, fix→fx, bugfix→bf, hotfix→hf, release→rl, chore→ch, refactor→rf

License

MIT