Claude Code 세션 관리를 위한 TUI 도구: Claude Manager 공개

커뮤니티 반응

작성자가 직접 개발한 도구에 대해 구현 방식과 일상 워크플로우 적용에 대한 피드백을 요청하며 긍정적인 반응을 얻고 있다.

주요 논점

01찬성다수

Claude Code의 기본 세션 관리 기능이 부족하므로 외부 관리 도구가 생산성 향상에 필수적이다.

합의점 vs 논쟁점

합의점

Claude Code의 세션 데이터가 JSONL 파일로 산재되어 있어 수동 관리가 매우 불편하다는 점에 동의한다.
데이터가 외부로 유출되지 않는 로컬 전용 관리 방식이 보안 측면에서 선호된다.

실용적 조언

수백 개의 세션 파일을 수동으로 뒤지는 대신 cm의 퍼지 검색 기능을 사용하여 프로젝트별 대화 기록을 관리하라.
Claude -p 플래그를 이용한 자동 명명 기능을 활성화하여 세션 목록의 가독성을 높여라.

섹션별 상세

Claude Code의 기본 세션 관리 한계를 극복하기 위해 로컬 TUI 매니저를 구축했다. 기존에는 ~/.claude/projects/ 디렉토리에 수백 개의 JSONL 파일이 생성되어 수동으로 검색하기 어려웠으나, 이 도구는 모든 세션을 캡처하여 인덱싱한다. 사용자는 cm 명령어를 통해 과거의 어떤 세션이든 원래의 디렉토리와 플래그 상태로 즉시 복구할 수 있다.

bash

eval "$(claude-manager init zsh)"

셸 설정 파일(.zshrc 등)에 추가하여 Claude Manager의 초기화 및 cm 함수를 활성화하는 코드

시스템 작동 방식은 Bash 후크를 통해 세션 이벤트를 감지하고 로컬 SQLite 데이터베이스에 기록하는 구조이다. 약 80라인의 Bash 후크가 현재 작업 디렉토리(CWD), 부모 프로세스의 인수(argv), Git 브랜치 정보 등을 추출하여 ~/.claudemanager/queue.jsonl에 저장한다. 이후 바이너리가 이 큐를 SQLite로 옮겨 데이터 무결성을 유지하며 태그나 즐겨찾기 기능을 제공한다.

bash

cm export --md > chat.md

Claude 세션 대화 내용을 마크다운 파일로 내보내는 명령어 예시

v0.2 버전에서는 비용 추적 및 데이터 시각화 기능을 포함한 4개 패널의 TUI를 제공한다. 모델별 비용 분석, 주간 사용량 통계, 30일 세션 활동 스파크라인 등을 통해 사용량을 모니터링할 수 있다. 또한 Claude의 -p 플래그를 활용해 대화 내용을 3단어 형태의 이름으로 자동 요약하여 저장하는 기능을 갖췄다.

보안과 이식성을 고려하여 모든 데이터는 로컬 기기에만 머물며 외부 API 키를 요구하지 않는다. 설치 시 기존 설정을 파괴하지 않는 비파괴적 병합 방식을 사용하며, 삭제 시에도 후크만 제거하고 데이터베이스는 보존하도록 설계했다. 현재 Linux와 macOS 환경을 지원하며 Bun 런타임을 기반으로 동작한다.

용어 해설

텍스트 사용자 인터페이스(TUI): — 터미널 환경에서 텍스트 기반으로 그래픽 인터페이스 요소를 구현하는 방식이다. 마우스 대신 키보드 단축키와 방향키로 조작하며, Claude Manager는 이를 통해 세션 목록을 시각적으로 관리한다.
JSON 라인(JSONL): — 각 줄이 유효한 JSON 객체인 텍스트 파일 형식이다. 대규모 로그 데이터나 Claude Code의 대화 기록처럼 순차적으로 추가되는 데이터를 저장하고 파싱하는 데 효율적이다.
퍼지 검색(Fuzzy Search): — 사용자가 입력한 검색어와 정확히 일치하지 않아도 유사한 패턴을 찾아내는 검색 방식이다. 수백 개의 세션 중 프로젝트명이나 태그의 일부만 입력해도 원하는 대화 기록을 빠르게 찾을 수 있게 돕는다.
SQLite: — 서버 없이 파일 형태로 운영되는 경량 관계형 데이터베이스 엔진이다. Claude Manager는 로컬 기기에 대화 메타데이터와 비용 통계 등을 저장하기 위해 단일 SQLite 파일을 사용한다.

언급된 도구

Claude Code중립

Anthropic의 CLI 기반 코딩 에이전트

Bun추천

JavaScript 런타임 및 패키지 매니저 (설치 필수 요구사항)

Ink중립

React를 사용하여 명령줄 인터페이스(CLI)를 구축하는 라이브러리

언급된 리소스

GitHubclaude-manager GitHub Repository