Session Kit – Claude Code 및 Codex 세션을 위한 터미널 대시보드

소개 – Session Kit은 여러 Claude Code 또는 Codex AI 코딩 세션을 보고, 구성하고, 이동할 수 있게 해주는 소형 로컬 명령줄 도구입니다. Linux(systemd) 및 macOS 14+에서 작동하며, 터미널이나 SSH 연결이 끊어져도 유지됩니다.

개발 이유 – 저자는 종종 여러 AI 지원 코딩 세션을 동시에 실행합니다. 각 세션을 유지하는 것은 쉽지만, 어느 것이 입력을 기다리고 있는지, 어느 것이 여전히 작업 중인지, 어느 것이 완료되었는지 기억하는 것은 어렵습니다. Session Kit은 단일 색상 코딩 목록을 제공하며, 각 세션에는 돌아가기 위해 입력할 수 있는 고정된 번호가 있습니다.

주요 기능

• 통합 선택기 – 하나의 화면에 모든 Claude Code 및 Codex 세션이 표시되며, 번호, 이름, 제공자, 계정, 모델, 상태 및 마지막 활동에 대한 열이 있습니다.
• 상태 힌트 – 세션은 question, needs you, working, idle 또는 pending으로 레이블이 지정되어 주의가 필요한 세션을 쉽게 발견할 수 있습니다.
• 번호 기반 이동 – 세션의 번호를 누르거나(또는 첫 번째 세션의 경우 Enter) 도구가 해당 라이브 세션에 연결됩니다.
• 연결 끊김 방지 – 터미널을 닫거나 SSH 연결이 끊어지더라도 세션은 호스트에서 계속 실행됩니다.
• 세션별 계정 – 각 세션은 다른 제공자 계정/구독을 사용할 수 있습니다. 계정은 터미널이 아닌 세션의 속성입니다.
• 종료된 세션 복원 – 세션을 닫으면 전체 대화 내용이 저장되고 나중에 다시 열 수 있습니다.
• 위임된 작업 격리 – 머신 발신 세션은 전용 브랜치에 자체 Git 워크트리를 가져 두 작업자가 동일한 파일을 편집하는 것을 방지합니다.
• 안전 모델 – UI(선택기)는 라이브 세션의 증명으로 신뢰되지 않습니다. 변경하기 전에 Session Kit은 정확한 제공자 프로세스 UUID와 세대를 재검증합니다. 증명이 실패하면 작업이 거부됩니다.
• 원격 측정 없음 – 모든 데이터는 호스트에 남습니다. 원격 서비스, 분석 또는 업데이트 비콘이 없습니다.

작동 방식(개요)

1. AI 작업이 실행되는 머신(systemd가 있는 Linux 또는 macOS 14+)에 Session Kit을 설치합니다. 이는 shpool 세션 관리자에 의존합니다.
2. kit을 실행하면 선택기 UI가 시작됩니다.
3. 세션을 선택하면(번호 또는 Enter) Claude Code 또는 Codex를 실행 중인 기본 shpool 관리 셸에 다시 연결됩니다.
4. 터미널을 닫을 때 shpool 프로세스가 AI 세션을 계속 살려둡니다. 나중에 다시 연결하면 동일한 세션 번호가 표시됩니다.
5. 모든 작업(열기, 닫기, 이동)은 라이브 제공자 프로세스가 저장된 ID와 일치한다는 단기 증명에 의해 보호됩니다.

설치 – README는 두 가지 경로를 제공합니다:

• AI 어시스턴트 바로가기 – 최신 릴리스 자산을 다운로드하고, SHA-256 체크섬을 확인하고, ./install.sh --check(읽기 전용 사전 점검)를 실행한 다음, ./install.sh를 실행하고 이어서 session-kit doctor 및 session-kit services enable을 실행하는 명령 블록을 AI에 제공합니다.
• 수동 스크립트 – 짧은 Python 스니펫이 GitHub 릴리스 API를 쿼리하고, tarball 및 체크섬 파일을 다운로드하여 확인하고, 추출한 다음 설치 스크립트를 실행합니다.

일반적인 워크플로우

# start the picker
kit

# open a new session (defaults to Claude Code)
sp new claude

# open a Codex session
sp new codex

# see which sessions need a reply
kit   # then press 'a'

# close a session by number
k 3   # from the picker

하지 않는 일

• 터미널 멀티플렉서(tmux 대체제)가 아닙니다.
• 토큰 비용을 추적하거나 코드 변경 사항의 diff를 제공하지 않습니다.
• 보안 샌드박스가 아닙니다. 잘못된 세션에서 작업하는 것으로부터 사용자를 보호할 뿐입니다.

문서 및 도움말 – 저장소에는 집중적인 가이드가 포함된 docs/ 폴더가 있습니다:

• install.md – 모든 설치 경로 및 shpool 세부 정보.
• usage.md – sp new, sp close, sp account enroll 등의 명령.
• configuration.md – 색상, 선택기 동작, 와치독 설정.
• picker-navigation.md – 키 바인딩 및 마우스 동작.
• security-and-data.md – 개인 정보 보호 모델 및 선택적 기록 저장.

성숙도 – 공개 베타 v0.4.3. 핵심 선택기, ID 증명 및 Claude Code/Codex 통합은 안정적입니다. 프로젝트는 빠르게 업데이트됩니다(3주 동안 13개 릴리스). 공식적인 지원은 없지만 저자는 이슈에 응답하고 보안 수정을 푸시합니다.

---

Session Kit은 여러 AI 코딩 세션을 관리하기 위한 진정한 오픈 소스 유틸리티로, Claude Code 또는 Codex를 집중적으로 사용하고 이를 추적할 수 있는 신뢰할 수 있는 방법이 필요한 개발자를 위한 것입니다.