코딩 에이전트를 지속되는 창에서 실행하고 작업·차단·대기 상태를 추적하며, CLI와 소켓 API로 에이전트가 직접 제어할 수 있는 Rust 터미널 워크스페이스입니다.
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
프로젝트를 clone한 후 소스에서 빌드하세요
make build - 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 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code에 컨텍스트 사용량, 요청 한도, 활성 도구, 실행 중인 에이전트, 할 일 진행 상황을 실시간으로 보여주는 상태 표시줄을 추가하는 플러그인입니다.
모델, git 브랜치, 토큰 사용량과 사용 한도 등을 표시하고 Powerline과 테마를 지원하는 Claude Code CLI용 커스텀 상태 표시줄입니다.
터미널 명령을 실행하고 ANSI 색상 출력을 창 스타일의 PNG 스크린샷으로 렌더링하는 CLI입니다.
명령 하나로 로컬 HTTP 서버를 공개 HTTPS URL에 연결하는 오픈소스 ngrok 대안입니다.