izll/agent-session-manager

tmux를 사용하여 여러 AI 코딩 어시스턴트 CLI 세션을 관리하는 강력한 터미널 UI(TUI) 애플리케이션입니다.

그래픽 앱을 선호하시나요? 동일한 세션 매니저가 데스크톱 애플리케이션인 ASMGR Desktop으로 존재합니다. 이는 Wails와 Svelte로 구축되었으며, 실제 터미널, diff 뷰어, 파일 브라우저 및 모바일 푸시 알림 기능을 제공합니다. 두 앱은 세션을 분리하여 유지하므로 둘 다 실행할 수 있습니다.

Claude Squad에서 영감을 받았습니다.

Claude Code - Anthropic의 CLI 코딩 어시스턴트
Gemini CLI - Google의 AI 비서
Aider - 터미널에서의 AI 페어 프로그래밍
OpenAI Codex - OpenAI의 코딩 어시스턴트
Amazon Q - AWS AI 코딩 컴패니언
OpenCode - 오픈 소스 AI 코딩 어시스턴트
Custom - 관리하려는 모든 CLI 명령어

재정렬(Reordering)** - 키보드 단축키로 세션 정리하기컴팩트 모드(Compact Mode) - 더 밀도 높은 뷰를 위해 세션 간 간격 토글스마트 리사이즈(Smart Resize) - 연결 시 터미널 크기 자동 조정, 분리 시 미리보기 크기 유지오버레이 대화 상자(Overlay Dialogs) - 적절한 유니코드 문자 너비 처리가 된 메인 뷰 위에 표시되는 모달 대화 상자화려한 상태 표시줄(Fancy Status Bar) - 강조된 키, 토글 표시기 및 구분 기호가 있는 스타일링된 하단 바스크롤 가능한 도움말 보기(Scrollable Help View) - 키보드 단축키, 상세 설명 및 스크롤 지원이 포함된 포괄적인 도움말 페이지세션 그룹(Session Groups) - 세션을 접을 수 있는 그룹으로 정리하여 더 나은 구성 제공즐겨찾기(Favorites) - 중요한 세션에 ⭐를 표시하여 목록 상단에서 빠르게 접근 가능하게 함세션 노트(Session Notes) - 세션 및 탭에 영구적인 메모/댓글 추가분할 보기(Split View) - 고정된 미리보기와 함께 두 세션을 나란히 비교Diff 보기(Diff View) - 미리보기 창에서 git 변경 사항 확인 (세션 diff 또는 전체 커밋되지 않은 내용)세션 검색(Session Search) - vim 스타일의 /를 사용하여 이름이나 노트로 세션 필터링

key전역 히스토리 검색(Global History Search) - 모든 에이전트 히스토리(Claude, Aider, OpenCode, Terminal)에서 Ctrl+F로 검색

포크 세션(Fork Session) - 분기된 대화를 위해 Claude 세션을 새 탭이나 별도의 세션으로 포크하기

• 터미널 멀티플렉서:
  Linux / macOS — tmux

Windows — psmux. 이는 tmux의 명령어 언어를 사용하는 네이티브 Windows 멀티플렉서이며, WSL이나 MSYS2가 필요하지 않습니다. Windows 설치 프로그램은 winget을 사용할 수 있는 경우(Windows 11 및 Windows 10 1809 이상) 자동으로 설치할지 여부를 제공합니다. 서버, LTSC, Sandbox 에디션에는 스토어가 없어 winget이 없으므로 psmux를 다운로드하여 PATH에 넣어야 합니다. WSL 또는 Cygwin의 tmux를 가리키고 싶다면 ASMGR_TMUX를 절대 경로로 설정하십시오.

• 설치된 AI CLI 도구 최소 1개:

brew tap izll/tap
brew install asmgr

업데이트:

brew upgrade asmgr

릴리스에서 asmgr_<버전>_windows_amd64_setup.exe를 다운로드하여 실행하십시오. 이는 사용자별로 설치되며(관리자 프롬프트 없음), asmgr를 배치합니다.

사용자의 PATH에 추가하고, 만약 psmux가 누락된 경우 설치할지 여부를 묻습니다.

이후 새로운 터미널을 열어야 합니다. 이미 실행 중인 터미널에서는 새로운 PATH를 인식하지 못합니다.

최신 버전을 자동으로 다운로드하여 설치하려면:

curl -fsSL https://raw.githubusercontent.com/izll/agent-session-manager/main/install.sh | bash

또는 로컬에서 다운로드하여 실행하려면:

curl -fsSL https://raw.githubusercontent.com/izll/agent-session-manager/main/install.sh -o install.sh
chmod +x install.sh
./install.sh

설치 옵션:

./install.sh # 최신 버전을 ~/.local/bin에 설치합니다.
./install.sh -v 0.6.5 # 특정 버전(0.6.5)을 설치합니다.
./install.sh -d /usr/local/bin # 사용자 지정 디렉터리에 설치합니다.
...

Debian/Ubuntu (.deb):

# 릴리스에서 다운로드
wget https://github.com/izll/agent-session-manager/releases/download/v0.7.5/asmgr_0.7.5_linux_x86_64.deb
sudo dpkg -i asmgr_0.7.5_linux_x86_64.deb

RedHat/Fedora/Rocky (.rpm):

# 릴리스에서 다운로드
wget https://github.com/izll/agent-session-manager/releases/download/v0.7.5/asmgr_0.7.5_linux_x86_64.rpm
sudo rpm -i asmgr_0.7.5_linux_x86_64.rpm

소스에서 빌드하는 것을 선호하는 경우 (Go 1.24+ 필요):

git clone https://github.com/izll/agent-session-manager.git
cd agent-session-manager
go build -o asmgr .
...

ASMGR에는 내장된 자체 업데이트 기능이 포함되어 있습니다. 애플리케이션을 실행하는 동안 U (Shift+U)를 누르기만 하면 됩니다:

• 업데이트가 사용 가능한 경우 오른쪽 상단 모서리에 황금색 ↑ 화살표가 나타납니다 - U를 눌러 업데이트를 확인합니다 - Y로 업데이트를 확정합니다.
• 업데이트가 자동으로 다운로드 및 설치됩니다
• 새 버전을 사용하려면 ASMGR을 재시작하십시오.

지원되는 설치 방법:

• ✅ Homebrew: brew upgrade asmgr을 통해 업데이트
• ✅ Debian/Ubuntu (.deb): 대화형 sudo dpkg -i 업데이트
• ✅ RedHat/Fedora/Rocky (.rpm): 대화형 sudo rpm -Uvh

업데이트 - ✅
설치 스크립트 (tar.gz) - 자동 바이너리 교체를 통한 자체 업데이트 - ✅
수동 설치 (tar.gz) - 사용자 디렉토리에 설치된 경우 자체 업데이트

Homebrew:

brew upgrade asmgr

패키지 관리자:

# Debian/Ubuntu
sudo apt update && sudo apt upgrade asmgr
# RedHat/Fedora
...

설치 스크립트:

curl -fsSL https://raw.githubusercontent.com/izll/agent-session-manager/main/install.sh | bash -s -- -u

간단히 실행:

asmgr

세션 비교(Session diff)는 세션 시작 이후의 변경 사항을 보여줍니다. 전체 비교(Full diff)는 커밋되지 않은 모든 변경 사항을 보여줍니다.

참고: Ctrl+q는 모든 tmux 세션에 대한 범용 빠른 분리(quick-detach)로 설정됩니다. ASMGR 세션은 적절한 미리보기 크기를 유지하기 위해 분리 전에 자동 크기 조정이 이루어집니다.

세션에 연결된 경우, ASMGR은 사용자 지정 tmux 상태 표시줄을 구성합니다:

SessionName │ main │ terminal │ claude-2 │ Alt+<>: tabs | Ctrl+Q: detach

세션 이름 (Session name)- 설정된 색상/그라디언트로 표시됩니다.탭 (Tabs)- 구분선과 함께 모든 창이 표시되며 (활성 탭은 흰색 볼드체), YOLO 지표 (YOLO indicator)- YOLO 모드가 활성화된 경우 활성 탭 이름 다음에 주황색 !로 표시됩니다.핵심 단축키 (Key hints)- 탭 전환 및 세션 분리(detach)에 대한 빠른 참고 자료를 제공합니다.

선택한 세션의 색상 선택기를 열려면 c를 누르세요:

전경색 (Foreground Colors)- 22가지 단색 + 15가지 그라디언트
배경색 (Background Colors)- 22가지 단색
자동 모드 (Auto Mode)- 대비되는 텍스트 색상을 자동으로 선택합니다.
전체 행 모드 (Full Row Mode)- 배경색을 전체 행 너비로 확장합니다 (토글하려면 f를 누르세요).
그라디언트 (Gradients)- 무지개(Rainbow), 일몰(Sunset), 바다(Ocean), 숲(Forest), 불(Fire), 얼음(Ice), 네온(Neon), 은하계(Galaxy), 파스텔(Pastel) 등 다양합니다!

전경색과 배경색 선택 사이를 전환하려면 Tab을 사용하세요.

지원되는 에이전트 (Claude, Gemini, Codex, OpenCode, Amazon Q)의 이전 대화를 이어서 진행할 수 있습니다:

• 아무 세션에서나 r을 누르세요 - 이전 대화 목록을 탐색합니다 (마지막 메시지와 타임스탬프 표시)
• 재개하거나 새로 시작할 대화를 선택하세요

참고: Aider와 사용자 정의 명령어는 세션 재개를 지원하지 않습니다.

아무 세션에서나 a를 눌러 시작 옵션을 확인하세요:

현재 세션 교체 (Replace current session)(1/r): 현재 세션을 중지하고 (실행 중인 경우) 새로운 세션을 시작합니다.
병렬 세션 시작 (Start parallel session)(2/n): 이름을 요청한 후 (기본값은 현재 세션 이름), 동일한 설정으로 새 인스턴스를 생성하여 목록의 현재 세션 바로 아래에서 시작합니다.

이를 통해 하나의 프로젝트 내에서 여러 작업을 동시에 작업할 수 있으며, 각 작업마다 자체 AI 세션을 가질 수 있습니다.

세션을 접을 수 있는 그룹으로 정리하고 즐겨찾기를 표시하세요:

⭐ 즐겨찾기 (Favorites) ▼ [2]
├── ● important-project
└── ● daily-tasks
...

• 아무 세션에서나 *를 눌러 즐겨찾기 토글: 즐겨찾기는 상단에 특별한 ⭐ 그룹으로 나타납니다.

• 세션은 원래 위치에도 남아 있습니다.

• 즐겨찾기 그룹은 비어 있을 때 숨겨집니다.

• 아무 세션에서나 g를 눌러 새 그룹을 만듭니다. - 선택된 세션을 그룹에 할당하려면 G를 누르세요. - 그룹 확장에는 →를, 축소에는 ←를 누릅니다. - Tab을 누르세요.

그룹을 토글(collapse/expand)하려면 e를 누르세요.

그룹의 이름을 바꾸려면 c를 누르세요.

그룹의 색상을 변경하려면 d를 누르세요.

그룹을 삭제하려면 (세션이 그룹에서 분리됨)

그룹에 속하지 않은 세션은 목록 하단에 표시됩니다.

세션 및 개별 탭에 영구적인 메모를 추가하세요:

• N을 누르세요.

(Shift+N)을 눌러 메모 편집기를 열 수 있습니다. (세션에 여러 개의 탭이 있는 경우, 메모는 탭별로 저장됩니다)

• 여러 줄의 메모 작성하기 (줄 바꿈은 Enter)
  Ctrl+S
  으로 저장하고,
  Esc
  으로 취소하며,
  Ctrl+D
  으로 지웁니다. - 메모는 세션/탭 정보 아래 미리보기 창에 표시됩니다.
• 메모는 세션 재시작 및 대화 변경에도 유지됩니다.

메모를 사용하여 다음을 추적하세요:

• 각 세션 또는 탭의 현재 작업/목표
• 중요한 맥락이나 결정 사항
• 할 일(TODOs) 및 알림
• 세션 간 전환 시 인계 메모