1939869736luosi/codex-sessions-manager

codex-sessions-manager은(는) 무엇을 하나요?

Codex / Claude Code 스킬 + CLI + MCP 서버 — 4단계 정리, 자동 롤백, 복구 가능한 휴지통, 검증.

개요

로컬 AI 에이전트 세션을 안전하고 체계적으로 관리하기 위한 다중 인터페이스 도구입니다. CLI, MCP 서버, 또는 에이전트 스킬로 사용할 수 있습니다.

주요 기능

• 4단계 정리 (4-layer cleanup): 심층, 표준, 빠름, 최소 — 상황에 맞는 세션 정리 수준
• 자동 롤백 (Auto-rollback): 세션 종료 시 변경 사항을 자동으로 되돌림
• 복구 가능한 휴지통 (Recoverable trash): 삭제된 세션을 보관하여 나중에 복구 가능
• 검증 (Verify): 세션 상태 무결성 확인 및 보고

설치

npm install -g @luosi/codex-sessions-manager
# 또는
pip install codex-sessions-manager

사용법

CLI

# 세션 목록 보기
csession list

# 세션 정리 (기본)
csession clean

# 세션 정리 (심층)
csession clean --deep

# 특정 세션 롤백
csession rollback <session-id>

# 세션 휴지통 보기
csession trash

# 휴지통에서 세션 복구
csession restore <session-id>

# 세션 검증
csession verify <session-id>

MCP 서버

{
  "mcpServers": {
    "sessions-manager": {
      "command": "npx",
      "args": ["-y", "@luosi/codex-sessions-manager", "mcp"]
    }
  }
}

스킬 (에이전트 내)

codex-sessions-manager가 설치된 환경에서 에이전트가 자동으로 감지하여 사용합니다.

구성

환경 변수	설명	기본값
SESSION_DIR	세션 데이터 디렉터리	~/.codex/sessions
TRASH_DIR	휴지통 디렉터리	~/.codex/trash
CLEANUP_LEVEL	기본 정리 수준	standard
AUTO_ROLLBACK	자동 롤백 활성화	true

정리 수준

• 심층 (deep): 모든 캐시, 임시 파일, Git 히스토리, 환경 변수 초기화
• 표준 (standard): 캐시, 임시 파일, Git 영향 최소화
• 빠름 (fast): 캐시만 정리
• 최소 (minimal): 세션 메타데이터만 정리

라이선스

MIT