ccfleet는 tmux에서 실행 중인 Claude Code 세션을 한 화면에 모아, 사용자 확인이 필요한 세션과 완료·진행 중인 세션을 보여주는 대시보드다. 알림을 울리는 대신 대기 시간순으로 확인할 세션을 정리하며, 키 하나로 해당 tmux 창으로 이동할 수 있다.
/를 누르면 세션 제목뿐 아니라 프롬프트와 Claude의 답변, 도구 출력 등 실시간 세션의 전체 기록을 검색한다. p로 목록 옆이나 아래에 미리보기를 켤 수 있고, 상태별·tmux 창별·저장소별로 묶어 볼 수도 있다. 완료 상태는 창이 보이거나 세션으로 이동했을 때, 또는 x를 눌렀을 때 확인한 것으로 처리한다. 선택형 포커스 훅을 설정하면 tmux에서 해당 창에 포커스를 둬도 확인한 것으로 표시된다.
macOS 또는 Linux와 tmux 3.2 이상, Claude Code가 필요하다. Homebrew로 설치하거나 릴리스 페이지에서 바이너리를 내려받고, go install github.com/jdbrewer/ccfleet@latest를 사용할 수도 있다. 설치 후 ccfleet tmux-snippet으로 tmux 설정 조각을 확인한 다음 ~/.tmux.conf에 추가하고 설정을 다시 불러온다. 이 설정은 prefix a로 팝업을 열고 상태 표시줄에 배지를 추가한다.
ccfleet는 파일을 읽기만 하며 훅이나 데몬이 필요하지 않다. 다만 Claude Code 내부 파일 형식에 의존해 그 형식이 릴리스에서 바뀔 수 있다. 파일을 읽지 못하면 문서화된 claude agents --json과 프로세스 트리를 이용하는 대체 경로로 전환되지만, 세션별 현재 상태 지속 시간은 볼 수 없게 된다. 이동과 미리보기에는 tmux가 필요하지만 ccfleet ls와 ccfleet grep은 tmux 밖에서도 작동한다.
검색은 실시간 세션만 대상으로 하며 각 도구 출력의 처음 16KB까지만 살핀다. 충돌 경고는 Claude의 Edit·Write 도구를 통한 수정만 감지하므로 Bash의 sed로 바꾼 파일은 포함하지 않는다. 컨텍스트 비율은 모델 이름이나 토큰 수에서 1M을 확인하지 못하면 200k 기준으로 계산한다.
데모 화면은 실제 세션이 아닌 가상의 세션 묶음으로 만들었다. python3 scripts/demo/demo.py로 화면을 다시 만들 수 있으며, --keep을 주면 실제 세션 없이 대시보드를 체험할 수 있는 데모 tmux 세션을 유지한다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요