Repolode
alchemmist

alchemmist/lazy-tmux

tmux 세션을 저장하고 TUI에서 골라 필요한 항목만 복원하는 Go CLI

스타
244
포크
9
열린 이슈
55
마지막 커밋
4일 전

어떤 프로젝트인가요?

lazy-tmux는 tmux 세션을 저장하고 복원하는 CLI 도구입니다. 창, pane 레이아웃, 실행 중인 명령과 선택적으로 스크롤백 기록을 저장하므로 tmux 서버를 종료한 뒤 나중에 작업 환경을 다시 불러올 수 있습니다.

복원은 필요한 항목만 선택하는 방식입니다. 대화형 TUI 트리·테이블 브라우저에서 퍼지 검색으로 복원할 세션이나 창을 고르거나, 더 가벼운 fzf 기반 선택기를 사용할 수 있습니다. 자동 저장 데몬은 백그라운드에서 모든 세션의 스냅샷을 저장하고, 부트스트랩 옵션을 사용하면 tmux가 시작될 때 가장 최근 세션을 복원할 수 있습니다.

또한 pane에서 실행 중인 Codex, Antex, Claude Code 에이전트 세션을 추적하며, 세션의 정체성이 확인된 경우에만 원래 대화를 복원합니다. tmux 2.9부터 3.7b까지 지원하며 Homebrew, AUR, Docker로 설치할 수 있습니다.

핵심 기능

  • 01현재 세션, 지정한 세션 또는 모든 세션의 창, pane, 레이아웃, 실행 중인 명령을 저장합니다.
  • 02필요한 세션이나 창만 선택해 복원합니다.
  • 03백그라운드 자동 저장 데몬이 주기적으로 세션 스냅샷을 저장합니다.
  • 04트리 뷰, 테이블, 퍼지 검색을 제공하는 대화형 TUI 선택기입니다.
  • 05선택적으로 fzf 기반 선택기와 팝업용 세션 전용 모드를 사용할 수 있습니다.
  • 06선택적으로 스크롤백을 저장하고 재생할 수 있습니다.

활용 사례

  • 재부팅하거나 tmux 서버를 종료한 뒤 전체 개발 환경을 복원할 때.
  • 팝업 선택기에서 여러 tmux 세션 사이를 빠르게 전환할 때.
  • 재시작 후에도 npm이나 docker-compose 같은 장시간 실행 명령이 pane에 배치된 상태를 유지할 때.

빠른 시작

  1. 1

    프로젝트를 clone한 후 소스에서 빌드하세요

    make build
  2. 2

    바이너리는 bin/lazy-tmux에 생성됩니다. 해당 위치에서 실행하세요

    bin/lazy-tmux

사용 전 알아둘 점

  • 소스에서 빌드하려면 Go와 clone한 저장소가 필요합니다. README에는 설치 명령이 안내되어 있지 않습니다.
  • Codex 및 Claude 에이전트 연동을 사용하려면 각 클라이언트에서 lifecycle hooks를 수동으로 설치하고 신뢰해야 합니다.
  • 전체 설정 및 사용법은 외부 웹사이트에서만 확인할 수 있습니다.

토픽

자주 묻는 질문

lazy-tmux은(는) 무엇인가요?
tmux 세션을 저장하고 TUI에서 골라 필요한 항목만 복원하는 Go CLI lazy-tmux는 tmux 세션을 저장하고 복원하는 CLI 도구입니다. 창, pane 레이아웃, 실행 중인 명령과 선택적으로 스크롤백 기록을 저장하므로 tmux 서버를 종료한 뒤 나중에 작업 환경을 다시 불러올 수 있습니다.
lazy-tmux은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
lazy-tmux은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
lazy-tmux은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. lazy-tmux의 마지막 커밋은 2026년 10월 17일입니다.
lazy-tmux은(는) 어디에 사용할 수 있나요?
재부팅하거나 tmux 서버를 종료한 뒤 전체 개발 환경을 복원할 때. 팝업 선택기에서 여러 tmux 세션 사이를 빠르게 전환할 때. 재시작 후에도 npm이나 docker-compose 같은 장시간 실행 명령이 pane에 배치된 상태를 유지할 때.
lazy-tmux는 어떻게 설치하나요?
프로젝트를 clone한 후 소스에서 빌드하세요: make build 바이너리는 bin/lazy-tmux에 생성됩니다. 해당 위치에서 실행하세요: bin/lazy-tmux
lazy-tmux은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/alchemmist/lazy-tmux

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트