Wallfacer: AI 코딩 에이전트를 위한 통합 터미널 세션 관리자

Wallfacer는 다양한 에이전트와 디렉토리 전반에 흩어져 있는 AI 코딩 세션의 파편화를 해결하기 위해 설계된 터미널 세션 관리자입니다. 에이전트의 원래 세션 파일을 수정하지 않고도 Claude Code, Cursor CLI, Kiro CLI, Codex의 세션을 이름 지정, 태그 지정, 그룹화 및 검색할 수 있는 통합된 읽기 전용 인덱싱 레이어를 제공합니다.

파편화된 AI 세션의 중앙 집중식 관리

AI 코딩 에이전트는 일반적으로 세션 트랜스크립트를 서로 다른, 종종 난독화된 위치에 저장합니다. 예를 들어, Claude Code는 ~/.claude/projects/에 이름 없는 JSONL 파일을 사용하고, Cursor CLI는 ~/.cursor/chats/에 해시 이름의 디렉토리를 사용하며, Kiro CLI는 ~/.kiro/sessions/cli/에 플랫 폴더를 사용합니다.

Wallfacer는 이러한 파일들을 ~/.local/share/wallfacer/에 위치한 로컬 SQLite 데이터베이스로 인덱싱합니다. 읽기 전용 오버레이로 작동함으로써, Wallfacer는 원본 데이터의 무결성을 유지하면서 제목, 태그, 프로젝트 그룹화에 대한 검색 가능한 메타데이터 레이어를 제공합니다.

핵심 기능 및 역량

Wallfacer는 전체 화면 터미널 사용자 인터페이스(TUI)와 자동화를 위한 명령줄 인터페이스(CLI)라는 이중 인터페이스 접근 방식을 제공합니다.

세션 조직 및 발견

Unified View: 모든 지원되는 에이전트와 디렉토리의 모든 세션을 최신순으로 표시합니다.
Metadata Overlay: 사용자는 세션을 이름 변경하거나, 태그를 적용하거나, 세션을 프로젝트로 그룹화하여 찾기 쉽게 만들 수 있습니다.
Advanced Search: 검색 기능은 제목, 첫 번째 프롬프트, 디렉토리, 프로젝트 및 태그를 아우릅니다.
Safe Deletion: rm 명령은 세션을 휴지통 폴더로 이동시키며, --purge 플래그를 사용해야만 영구 삭제가 수행됩니다.

멀티 에이전트 지원

Wallfacer는 플러그형 어댑터 인터페이스를 사용하여 여러 에이전트를 병렬로 지원할 수 있습니다. 현재 지원되는 에이전트는 다음과 같습니다:

Claude Code
Cursor CLI
Kiro CLI
Codex

인터페이스 및 사용법

The TUI (Interactive Browser)

wallfacer 명령어를 그대로 실행하면 전체 화면 브라우저가 열립니다. 인터페이스는 왼쪽에 세션 목록이 있고 오른쪽에 상세 정보 창이 있습니다. 주요 단축키는 다음과 같습니다:

/: 메타데이터 전반에 걸친 퍼지(Fuzzy) 필터링.
Enter: 세션을 재개하여 에이전트에게 제어권을 넘기고, 종료 시 브라우저로 돌아옵니다.
n: 에이전트, 디렉토리, 제목을 선택하여 새로운 세션을 시작합니다.
r / t / p: 이름 변경, 태그 편집, 또는 프로젝트 설정.

The CLI (One-shot Commands)

스크립팅 및 빠른 접근을 위해 Wallfacer는 서브 명령어를 제공합니다:

wallfacer new [dir]: 특정 디렉토리에서 새로운 세션을 시작합니다.
wallfacer resume <ref>: ID 접두사 또는 정확한 제목을 사용하여 세션을 다시 엽니다.
wallfacer list: 프로젝트, 태그 또는 에이전트별로 선택적 필터를 적용하여 세션을 목록화합니다.
wallfacer search <query>: 제목, 프롬프트 및 태그를 검색합니다.

기술적 구현

Wallfacer는 Go (Go 1.22+ 필요)로 작성되었으며, SQLite 인덱스를 유지하기 위해 증분 동기화 프로세스를 사용합니다. 세션 파일의 헤더를 스캔하여 작업 디렉토리, 타임스탬프, 첫 번째 프롬프트를 추출하여 자동 제목을 생성합니다.

단일 세션을 여러 파일에 분산시키는 에이전트(예: Kiro CLI의 트랜스크립트와 사이드카 파일 또는 Cursor CLI의 분할된 디렉토리)의 경우, Wallfacer는 전체 세트를 하나의 관리 및 삭제 단위로 취급합니다.

커뮤니티 인사이트 및 관점

Hacker News 사용자들은 다양한 서브 디렉토리에서 세션이 시작되어 Wallfacer와 같은 도구구를 사용하지 않으면 추적하기 어려운 대규모 모노레포에서의 세션 관리의 고면을 강조했습니다.

"I work in a massive monorepo with a bunch of different services... I realized I was starting Claude Code sessions everywhere... I built Wallfacer because I needed a way to search and resume these sessions without messing with the source of truth."

일부 사용자들은 Claude Code의 내장된 /rename 명령어와 같은 기존 유틸리티나 tmux와의 비교하여 도구의 필요성에 대해 의문을 제기하기도 했지만, 다른 사용자들은 현재 오픈소스 생태계에서