Show HN: Wallfacer – A terminal session manager for Claude Code, and more

개요

Wallfacer는 Claude Code, Cursor CLI, Kiro CLI, Codex 등 여러 AI 코딩 에이전트의 터미널 세션을 관리하는 도구로, 모든 AI 코딩 세션을 중앙에서 확인하고, 이름을 지정하고, 태그를 지정하고, 그룹화하고, 검색하고, 다시 시작하거나 삭제할 수 있습니다.

주요 내용

• AI 코딩 세션 관리에 대한 문제점: Claude Code, Kiro CLI, Cursor CLI, Codex 등 다양한 AI 코딩 도구들이 세션을 서로 다른 방식으로 저장하여 세션 수가 많아질수록 구별하기 어렵고 필요한 세션을 찾기 힘들어진다.
• Wallfacer의 기능:
• 통합 보기: 모든 디렉토리와 모든 에이전트의 모든 세션을 최신순으로 정렬하여 한눈에 볼 수 있다.
• 정리: 세션 이름을 변경하고, 태그를 지정하고, 프로젝트로 그룹화할 수 있다.
• 검색: 세션 제목, 첫 프롬프트, 디렉토리, 프로젝트, 태그별로 검색이 가능하다.
• 실행 및 재개: 새로운 세션을 시작하거나 기존 세션으로 바로 돌아갈 수 있다.
• 멀티 에이전트 지원: Claude Code, Cursor CLI, Kiro CLI, Codex 세션을 나란히 관리하고, 세션 시작 시 에이전트를 선택하거나 필터링할 수 있다.
• 안전한 삭제: rm 명령은 세션을 휴지통으로 이동시키며, --purge 옵션을 사용해야 영구적으로 삭제된다.
• TUI 및 CLI: 사용자를 위한 전체 화면 브라우저(TUI)와 스크립트 및 빠른 명령을 위한 서브커맨드(CLI)를 제공한다.
• 확장성: 에이전트는 플러그인 가능한 어댑터 방식으로 지원되며, opencode 어댑터가 로드맵에 포함되어 있다.
• 설치 방법: Homebrew(macOS/Linux) 또는 Go 명령어를 통해 설치할 수 있다.
• 사용 방법:
• TUI (터미널 사용자 인터페이스): wallfacer 명령어로 실행되며, 세션 목록과 세부 정보를 보여주는 전체 화면 브라우저를 제공한다. 키보드 단축키를 통해 세션 필터링, 재개, 이름 변경, 태그 추가/제거, 프로젝트 설정/해제, 삭제 등의 작업을 수행할 수 있다.
• CLI (명령줄 인터페이스): wallfacer <command> 형태로 사용되며, 세션 시작, 재개, 목록 보기, 검색, 상세 정보 보기, 이름 변경, 태그 관리, 프로젝트 관리, 삭제 등의 단일 작업을 수행한다. --json 옵션을 사용하여 스크립트에서 활용할 수 있다.
• 작동 방식: Wallfacer는 설정된 디렉토리(~/.claude/projects/, ~/.cursor/chats/, ~/.kiro/sessions/cli/, ~/.codex/sessions/)를 스캔하여 세션 파일을 읽고, 세션의 작업 디렉토리, 타임스탬프, 첫 프롬프트 등의 정보를 수집한다. 수집된 메타데이터는 로컬 SQLite 데이터베이스(~/.local/share/wallfacer/)에 저장되며, 에이전트 파일은 변경하지 않는다. rm 명령은 세션을 Wallfacer의 휴지통으로 이동시키며, 여러 파일로 분산된 세션도 함께 관리한다.
• 향후 로드맵: Claude Code, Cursor CLI, Kiro CLI, Codex 외 추가 에이전트 어댑터 지원, opencode 어댑터, 선호 에이전트 설정, 세션 내용 전체 텍스트 검색, 세션 복원 기능, 세션 통계, Markdown으로 내보내기, 데스크톱 애플리케이션 등이 계획되어 있다.

시사점

Wallfacer는 분산된 AI 코딩 세션 관리의 복잡성을 해소하고, 사용자가 여러 AI 도구의 작업 기록을 효과적으로 추적, 검색 및 재사용할 수 있도록 지원하여 개발 생산성을 향상시킬 수 있는 잠재력을 가진다.