{"id":47728878,"url":"https://github.com/bae-changhyun/cc-session-utils","last_synced_at":"2026-04-06T07:01:35.069Z","repository":{"id":344779030,"uuid":"1183012221","full_name":"Bae-ChangHyun/cc-session-utils","owner":"Bae-ChangHyun","description":"Terminal UI for managing Claude Code sessions, projects, and data","archived":false,"fork":false,"pushed_at":"2026-04-01T07:52:43.000Z","size":4582,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T06:35:04.586Z","etag":null,"topics":["claude","claude-code","session-manager","terminal","textual","tui"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/cc-session-utils/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bae-ChangHyun.png","metadata":{"files":{"readme":"README.ko.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-16T07:21:55.000Z","updated_at":"2026-04-01T07:46:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Bae-ChangHyun/cc-session-utils","commit_stats":null,"previous_names":["bae-changhyun/cc-session-utils"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/Bae-ChangHyun/cc-session-utils","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bae-ChangHyun%2Fcc-session-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bae-ChangHyun%2Fcc-session-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bae-ChangHyun%2Fcc-session-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bae-ChangHyun%2Fcc-session-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bae-ChangHyun","download_url":"https://codeload.github.com/Bae-ChangHyun/cc-session-utils/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bae-ChangHyun%2Fcc-session-utils/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31463015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","claude-code","session-manager","terminal","textual","tui"],"created_at":"2026-04-02T21:10:08.772Z","updated_at":"2026-04-06T07:01:35.054Z","avatar_url":"https://github.com/Bae-ChangHyun.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://cdn.simpleicons.org/anthropic/D97757\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://cdn.simpleicons.org/anthropic/1A1915\"\u003e\n  \u003cimg alt=\"Claude\" width=\"48\" height=\"48\"\u003e\n\u003c/picture\u003e\n\n# cc-session-utils\n\n**Claude Code 세션 관리 터미널 UI**\n\n[![Python](https://img.shields.io/badge/Python-3.11%2B-D97757?style=for-the-badge\u0026logo=python\u0026logoColor=white)](https://python.org)\n[![Textual](https://img.shields.io/badge/Textual-TUI-D97757?style=for-the-badge)](https://github.com/Textualize/textual)\n[![License](https://img.shields.io/badge/License-MIT-D97757?style=for-the-badge)](LICENSE)\n[![Platform](https://img.shields.io/badge/Linux%20%7C%20macOS%20%7C%20Windows-1A1915?style=for-the-badge)](#)\n\n사용량 통계 · 세션 정리 · 마이그레이션 · 백업/복원 — 터미널에서 한눈에\n\n**[English](README.md)**\n\n\u003c/div\u003e\n\n---\n\n## 데모\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"docs/demo.gif\" alt=\"cc-session-utils 데모\" width=\"800\"/\u003e\n\u003c/div\u003e\n\n---\n\n## 왜 만들었나요?\n\nClaude Code를 많이 사용할수록 `~/.claude` 디렉토리에 파일이 쌓이고, 어떤 프로젝트가 얼마나 비용을 쓰는지, 어떤 파일이 정리되지 않고 남아있는지 파악하기 어렵습니다.\n\n**cc-session-utils**는 터미널을 벗어나지 않고 대시보드로 사용량을 파악하고, 불필요한 orphaned 데이터를 안전하게 정리할 수 있습니다.\n\n---\n\n## 주요 기능\n\n### 📊 대시보드\n- 총 사용 비용 및 모델별(Opus / Sonnet / Haiku) 토큰/비용 통계\n- 일별 / 주별 / 월별 사용량 테이블\n- 프로젝트별 비용 Top 10 바 차트\n- 데이터 개요: 세션 수, 파일 히스토리, 디버그/투두 파일, 디스크 사용량\n\n### 📁 프로젝트 관리\n- `.claude.json` 기반 프로젝트 목록을 트리 구조로 표시\n- 세션 클릭 시 대화 내용 미리보기\n- 개별 세션 삭제, 설정에서 프로젝트 제거\n- Orphaned 세션 일괄 감지 및 정리\n- `--path` 옵션으로 특정 프로젝트만 필터링\n\n### 📋 파일 히스토리\n- Claude가 편집한 파일의 버전 스냅샷 관리\n- Orphaned 항목 감지 및 일괄 정리\n\n### 🐛 Debug / Todos\n- 디버그 로그 및 투두 메모 관리, 미리보기 패널\n- 빈 파일 및 Orphaned 파일 일괄 정리\n\n### 🔄 세션 마이그레이션\n- 프로젝트 간 세션 복사 (원본 유지)\n- **개별 세션 선택:** `Space`로 체크/해제, `Enter`로 대화 미리보기\n- Append / Overwrite 모드\n- 경로 참조 자동 업데이트\n\n### 💾 백업 / 복원\n- 설정 백업 (`.claude.json`) 또는 전체 백업 (`~/.claude`)\n- 복원 전 자동 안전 백업\n- 복원 실패 시 자동 롤백\n\n---\n\n## 설치\n\n```bash\n# pip\npip install cc-session-utils\n\n# uv\nuv tool install cc-session-utils\n\n# 소스에서 설치\ngit clone https://github.com/Bae-ChangHyun/cc-session-utils.git\ncd cc-session-utils\nuv sync \u0026\u0026 uv run cc-tui\n```\n\n설치 후에는 `cc-tui`와 `cc-session-utils` 두 실행 명령이 함께 생기며, 둘 다 같은 앱을 실행합니다.\n\n---\n\n## 사용법\n\n```bash\ncc-tui                          # 기본 실행\ncc-session-utils                # 같은 앱을 실행하는 다른 명령어\ncc-tui --path /your/project     # 특정 프로젝트 필터링\ncc-tui --lang ko                # 한국어 UI\n```\n\n### 키보드 단축키\n\n| 키 | 동작 |\n|:---:|:---|\n| `F1`~`F6` | 탭 전환 |\n| `Tab` / `Shift+Tab` | 대시보드 기간(Daily / Weekly / Monthly) 순환 |\n| `1` / `2` / `3` | 대시보드 기간 바로 전환 |\n| `q` | 앱 종료 |\n| `r` | 전체 새로고침 |\n| `d` / `D` | 선택 삭제 / 전체 Orphaned 삭제 |\n| `Space` | 선택 토글 |\n| `Enter` | 세션 대화 미리보기 (Migrate 탭) |\n\n---\n\n## 관리되는 데이터 경로\n\n| 경로 | 설명 |\n|:---|:---|\n| `~/.claude.json` | 프로젝트 목록, 비용, 모델 사용량 |\n| `~/.claude/projects/` | 세션 JSONL 파일 |\n| `~/.claude/file-history/` | 파일 버전 스냅샷 |\n| `~/.claude/debug/` | 디버그 로그 |\n| `~/.claude/todos/` | 투두 메모 |\n| `~/.cc-tui/backups/` | 백업 파일 |\n| `~/.cc-tui/trash-log.jsonl` | 삭제 이력 로그 |\n\n---\n\n## 주의사항\n\n\u003e **삭제 작업은 모두 OS 휴지통으로 이동**됩니다. 휴지통에서 복구 가능합니다.\n\u003e\n\u003e 전체 백업은 `~/.claude` 통째로 복사하므로 디스크 용량을 확인하세요.\n\u003e\n\u003e Claude Code **내부 데이터를 직접 조작**합니다. 중요 작업 전 반드시 백업하세요.\n\n---\n\n## 라이선스\n\n[MIT](LICENSE)\n\n\u003cdiv align=\"center\"\u003e\n\u003cbr/\u003e\nMade with \u003cb\u003eClaude Code\u003c/b\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbae-changhyun%2Fcc-session-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbae-changhyun%2Fcc-session-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbae-changhyun%2Fcc-session-utils/lists"}