ccview

Claude Code의 모든 상태를 확인할 수 있는 인터랙티브 CLI 도구입니다.

기능

• 기본 정보: 시작 횟수, 설치 방법, 자동 업데이트 설정 등
• MCP 서버: 설정된 MCP 서버 목록 및 상세 정보
• 프로젝트 목록: 모든 프로젝트 목록 및 상세 정보
  • 프로젝트별 통계 (비용, 토큰 사용량, 지속 시간)
  • 프로젝트별 히스토리 (최근 5개 + 전체 보기 옵션)
  • 전체 프롬프트 복사: 프로젝트의 모든 대화 히스토리를 클립보드에 복사
  • 파일 저장: 복사한 프롬프트를 텍스트 파일로 저장
  • 프로젝트별 MCP 서버 설정
• 팁 히스토리: 표시된 팁 목록 및 표시 횟수

설치

개발 환경

# 의존성 설치
pnpm install

# 로컬 테스트
pnpm link
ccview

npm 발행 후 (사용자)

# 전역 설치
npm install -g ccview

# 또는 pnpm
pnpm add -g ccview

# 실행
ccview

실행

# npm 스크립트로 실행
pnpm start

# 또는 직접 실행
node index.js

# 또는 전역 설치 후 실행
ccview

사용법

1. CLI를 실행하면 메인 메뉴가 표시됩니다
2. 방향키(↑/↓)로 메뉴를 선택합니다
3. Enter 키를 눌러 선택한 메뉴로 이동합니다
4. 프로젝트 목록에서 특정 프로젝트를 선택하면 상세 정보를 볼 수 있습니다
5. 프로젝트 상세 화면에서:
   • 전체 히스토리 보기: 프로젝트의 모든 대화 히스토리 조회
   • 클립보드에 복사: 모든 대화를 클립보드에만 복사
   • 파일로 저장: 프롬프트를 프로젝트명_prompts_날짜.md 파일로 저장
6. 각 화면에서 Enter 키를 누르면 메인 메뉴로 돌아갑니다
7. "종료"를 선택하여 CLI를 종료합니다

프롬프트 복사 예시

프로젝트의 전체 대화를 복사하면 다음과 같은 형식으로 저장됩니다:

YAML 헤더:

---
project: /Users/username/Dev/my-project
project_name: my-project
total_prompts: 20
exported_at: 2025-10-23T12:34:56.789Z
---

프롬프트 내용: (4개의 백틱으로 감싸져 있어 내부의 코드 블록과 충돌하지 않음)

[1/20]
첫 번째 프롬프트 내용

[2/20]
두 번째 프롬프트 내용

붙여넣기 내용 (에러 로그, 코드 등)

[3/20]
세 번째 프롬프트 내용
...

메뉴 옵션 설명

프로젝트 상세 화면에서 히스토리 확인 후 다음 옵션을 선택할 수 있습니다:

1. 전체 히스토리 보기: 모든 프롬프트를 테이블 형식으로 터미널에 표시
2. 클립보드에 복사: 위 형식으로 변환하여 클립보드에만 복사
3. 파일로 저장: 현재 디렉토리에 .md 파일로 저장
4. 뒤로 가기: 프로젝트 상세 화면으로 복귀

파일 저장 위치

파일로 저장 시 현재 작업 디렉토리에 저장됩니다:

• 파일명 형식: 프로젝트명_prompts_YYYYMMDDHHmmss.md (로컬 시간 기준)
• 예시: ccview_prompts_20251023021639.md
• 저장 위치: CLI를 실행한 디렉토리

스크린샷

╔════════════════════════════════════╗
║   Claude Code 상태 확인 CLI   ║
╚════════════════════════════════════╝

? 확인할 정보를 선택하세요: (Use arrow keys)
❯ 기본 정보
  MCP 서버
  프로젝트 목록
  팁 히스토리
  종료

설정 파일 경로

• macOS/Linux: ~/.claude.json
• Windows: %USERPROFILE%\.claude.json

의존성

• inquirer: 인터랙티브 CLI 메뉴
• chalk: 터미널 색상 출력
• cli-table3: 테이블 형식 출력
• json5: JSON5 형식 파싱 (주석 지원)
• clipboardy: 클립보드 복사 기능

개발자를 위한 정보

npm 패키지 발행

자세한 발행 가이드는 NPM_PUBLISH_GUIDE.md를 참조하세요.

빠른 발행 가이드

# 1. npm 로그인
npm login

# 2. 버전 업데이트
npm version patch  # 또는 minor, major

# 3. 발행 전 테스트
npm publish --dry-run

# 4. 발행
npm publish

# Scoped 패키지의 경우
npm publish --access public

주요 체크포인트

• ✅ package.json에 필수 정보 입력 (name, version, description, author, repository)
• ✅ README.md 작성
• ✅ LICENSE 파일 생성
• ✅ .npmignore 설정
• ✅ 로컬에서 pnpm link로 테스트
• ✅ Node.js 버전 호환성 확인 (engines 필드)

프로젝트 구조

ccview/
├── index.js              # 메인 CLI 파일
├── package.json          # 패키지 설정
├── README.md            # 사용 설명서
├── LICENSE              # MIT 라이센스
├── .gitignore           # Git 제외 파일
├── .npmignore           # npm 발행 제외 파일
└── NPM_PUBLISH_GUIDE.md # 발행 가이드

기여하기

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

라이센스

MIT