이 글은 Agent Deck v1.9.57(2026-06-12 출시)을 기준으로 하며, PR 번호는 이미 #1408에 달해 프로젝트 업데이트가 매우 활발합니다.
1. 왜 AI 에이전트 관리자가 필요할까?
2026년 AI 코딩 도구 생태계는 완전히 달라졌습니다. 1년 전만 해도 개발자에게 Claude Code나 Aider 하나면 충분했죠. 하지만 요즘 중급 이상의 개발자 워크플로우는 대략 이렇습니다:
- Claude Code: 핵심 비즈니스 로직 처리
- OpenCode: 코드 리뷰
- Codex: 단위 테스트 작성
- Gemini CLI: 빠른 프로토타입 검증
- Pi: 문서 생성
계산해 보면, AI 에이전트 5개 × 프로젝트 3개 = 터미널 탭 15개입니다. 여기에 디버깅용 터미널, 데이터베이스 클라이언트, 로그 뷰어까지 손수 띄우면요.
터미널 탭 지옥
이런 경험, 다들 한 번쯤 있으시죠:
- 어떤 탭이 어떤 에이전트인지 까먹고
git checkout을 엉뚱한 브랜치에서 실행 - Claude Code가 답변을 기다리는데, 도저히 해당 탭을 찾을 수가 없음
- Claude 세션 간에 대화 맥락을 옮기려면 일일이 수동으로 복사·붙여넣기
- MCP 설정 파일은 만질수록 엉망, 프로젝트 바꿀 때마다 손수 수정
기존方案的 문제점
| 대안 | 문제점 |
|---|---|
| 터미널 여러 개 직접 열기 | 관리가 아예 불가능, 탭 폭발 |
| tmux로 수동 화면 분할 | 단축키 다 외워야 하고, 상태 파악도 안 됨 |
| cc-switch | 데스크톱 GUI 방식이지만 터미널 수준 세션 관리 기능 부족 |
| Aider | 단일 도구라서 여러 에이전트를 관리할 수 없음 |
Agent Deck은 바로 이 문제를 해결하려고 만들어졌습니다. AI 코딩 도구가 아니라 — 모든 AI 코딩 도구의 컨트롤 센터인 거죠.
2. Agent Deck이란?
Agent Deck(GitHub: asheshgoplani/agent-deck)은 AI 코딩 에이전트 전용 오픈소스 터미널 세션 관리자입니다. tmux 기반으로 만들어졌으며, 단일 터미널 창 안에 TUI(터미널 사용자 인터페이스)를 제공해서 다음을 가능하게 합니다:
- 모든 AI 에이전트 상태를 한눈에 확인 (실행 중 / 입력 대기 / 유휴 / 오류)
- 버튼 하나로 에이전트 간 전환
- 세션 Fork — 기존 대화에서 새로운思路로 분기
- MCP 서비스와 Claude Skills를 시각적으로 관리
- 여러 AI 에이전트를 원격 모니터링 및 오케스트레이션 (Conductor 기능)
핵심 철학: 또 하나의 AI 코딩 도구가 아니라, 터미널 AI 개발 워크플로우의 컨트롤 센터입니다.
핵심 데이터
| 지표 | 수치 |
|---|---|
| 프로그래밍 언어 | Go 1.24+ |
| 하부 기술 | tmux 멀티 세션 관리 |
| 지원 플랫폼 | macOS / Linux / WSL |
| 최신 버전 | v1.9.57 (2026-06-12) |
| PR 번호 | #1408+ |
| 오픈소스 라이선스 | MIT |
3. 설치 및 초기화 (5분 만에 시작하기)
설치 방법
Agent Deck은 세 가지 설치 방법을 제공하며, Homebrew 설치가 가장 간편합니다:
# 방법 1: Homebrew (추천, macOS / Linux 공용)
brew install asheshgoplani/tap/agent-deck
# 방법 2: 빠른 설치 스크립트
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash
# 방법 3: Go install
go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest
첫 세션 만들기
설치가 끝나면 터미널에서 다음을 실행합니다:
# Agent Deck TUI를 시작하고 project-alpha라는 세션 생성
agent-deck session start project-alpha
tmux 기반의 TUI 화면이 나타납니다. 아직 AI 에이전트를 설정하지 않았다면, Agent Deck이 설정을 안내해 줍니다.
기본 TUI 조작
TUI에 진입하면 주로 쓰는 탐색 단축키는 다음과 같습니다:
| 단축키 | 기능 |
|---|---|
j / k 또는 ↓ / ↑ |
세션 목록에서 위아래로 이동 |
gg |
목록 맨 위로 이동 |
G |
전역 검색 열기 (모든 Claude 대화) |
/ |
모든 세션에서 퍼지 검색 |
1-9 |
N번째 루트 그룹으로 이동 |
? |
전체 단축키 목록 보기 |
상태별 필터 검색 (매우 유용):
| 단축키 | 필터 상태 |
|---|---|
! |
실행 중(Running) 세션만 표시 |
@ |
입력 대기(Waiting) 세션만 표시 |
# |
유휴(Idle) 세션만 표시 |
$ |
오류(Error) 세션만 표시 |
그룹 내 탐색 (v1.7.60+新增 Alt+ 단축키, 현재 그룹 안에서만 이동):
| 단축키 | 기능 |
|---|---|
Alt+j / Alt+k |
현재 그룹 안에서 위/아래 세션 이동 (그룹 경계 넘어가지 않음) |
Alt+1 ~ Alt+9 |
현재 그룹 내 N번째 세션으로 이동 |
Alt+g / Alt+G |
현재 그룹의 첫 번째/마지막 세션 |
Alt+/ |
현재 그룹 안에서만 퍼지 검색 |
스마트 상태 표시
Agent Deck은 스마트 폴링을 통해 각 에이전트 상태를 실시간으로 감지합니다:
| 상태 | 기호 | 의미 |
|---|---|---|
| 실행 중 | ● 녹색 | 에이전트가 actively 작업 중 |
| 대기 중 | ◐ 황색 | 사용자 입력/답변 필요 |
| 유휴 | ○ 회색 | 준비 완료, 명령 대기 |
| 오류 | ✕ 적색 | 오류 발생 |
대기 중인 세션은 tmux 상태 표시줄에 바로 표시됩니다: Ctrl+b를 누르고 뗀 뒤 1-6을 누르면 해당 대기 세션으로 바로 이동합니다. 상태 표시줄은 이렇게 표시됩니다:
⚡ [1] frontend [2] api [3] backend
4. 핵심 기능 실전 활용
4.1 Fork 세션: 하나의 기능, 여러 구현, 서로 간섭 없음
Fork는 Agent Deck의 가장 차별화된 기능 중 하나입니다. 이런 상황을 상상해 보세요: Claude Code로 API 인터페이스를 설계했고, 이제 두 가지 다른 구현 방식을 시도하고 싶다고 칩시다. 기존 방법이라면 새 세션을 열고 요구사항을 처음부터 다시 설명해야 합니다. 하지만 Fork가 있으면:
# TUI에서 fork할 세션에 커서를 올린 뒤
# f 누르기 → 빠른 fork (이름 자동 생성)
# F 누르기 → fork 후 이름과 그룹 직접 지정
Fork의 핵심 가치:
- 새 세션이 부모 세션의 전체 대화 이력을 물려받음
- Claude / OpenCode / Pi / Codex의 네이티브 fork 지원 (도구 자체의 fork 기능)
- fork한 뒤 또 fork 가능, 원하는 만큼 분기思路 탐색
- 각 분기는 서로 간섭 없이, 언제든 비교 가능
⚠️ 주의: Codex의 fork 기능은 codex CLI 버전 ≥ 0.137.0이 필요합니다.
4.2 MCP Manager: 설정 파일 안 건드려도 MCP 서비스 관리
MCP(Model Context Protocol) 서비스는 AI 에이전트가 외부 도구(웹 검색, 브라우저 자동화, 데이터베이스 쿼리 등)에 접근할 수 있게 해 줍니다. 기존 관리 방식은 JSON 설정 파일을 직접 수정해야 했지만, Agent Deck은 이를 TUI 시각화 조작으로 만들었습니다:
TUI에서 m을 눌러 MCP Manager 열기:
| 작업 | 단축키 |
|---|---|
| MCP 서비스 활성화/비활성화 | Space (스페이스바) |
| LOCAL / GLOBAL 범위 전환 | Tab |
| 이름으로 이동 | 그냥 타이핑 |
MCP 설정 위치: ~/.config/agent-deck/config.toml
설정 예시:
[[mcp_servers]]
name = "web-search"
command = "npx"
args = ["-y", "@anthropic/mcp-server-brave-search"]
TUI에서 설정을 마치면, Agent Deck이 해당 에이전트 세션을 자동으로 재시작하여 변경 사항을 적용합니다. 수동 재시작이 전혀 필요 없습니다.
4.3 Skills Manager: 프로젝트별로 Claude Skills 관리
Claude Code 사용자를 위해, Agent Deck에는 Skills Manager가 내장되어 있어 프로젝트별로 Claude Skills를 풀(pool) 단위로 관리할 수 있습니다:
TUI에서 s를 눌러 Skills Manager 열기 (Claude 세션에만 유효):
- 풀化管理: 사용 가능한 스킬 목록은 풀(
~/.config/agent-deck/skills/pool)에서만 가져와서 attach/detach 조작의 예측 가능성을 보장 - 프로젝트별 상태: 프로젝트 상태는
.agent-deck/skills.toml에 기록되고, 스킬 파일은.claude/skills디렉토리에 물리화됨 - 타이핑 이동: MCP Manager와 동일한 이름 기반 이동 인터랙션
즉, 프로젝트마다 다른 Skill 조합을 설정할 수 있습니다. 예를 들어:
project-alpha: web-search + code-review 스킬 attachedproject-beta: api-testing + docs-generation 스킬 attached
4.4 MCP Socket Pool: 다중 세션에서 메모리 85% 절감
여러 세션을 동시에 실행하고 각 세션이 같은 MCP 서비스에 연결하면, 메모리 사용량이 기하급수적으로 늘어납니다. Agent Deck의 MCP Socket Pool은 Unix Socket을 통해 여러 세션이 동일한 MCP 프로세스를 공유하게 합니다:
# config.toml에서 활성화
[mcp]
pool_all = true
효과:
- MCP 메모리 사용량 85~90% 감소
- MCP 프로세스 크래시 시 약 3초 내 자동 재연결 (reconnecting proxy)
- 상위 에이전트에게 완전히 투명, 코드 수정 불필요
4.5 그룹별 독립 Claude 설정
동일 머신에서 여러 Claude 계정(예: 개인 계정과 업무 계정)을 관리할 때, Agent Deck은 그룹별로 다른 Claude 인증을 설정할 수 있게 해 줍니다:
# config.toml
[groups."conductor".claude]
config_dir = "~/.claude-work"
env_file = "~/git/work/.envrc"
검색 우선순위: 환경 변수 > 그룹 > 프로필(profile) > 글로벌 > 기본값
env_file은 tmux pane 시작 전에 로드되며,其中的 export는 세션 환경의 일부가 됩니다. 다른 API Key나 다른 Claude 작업 디렉토리가 필요한 경우에 매우 유용합니다.
5. 고급 활용: Conductor 오케스트레이션
Conductor란?
Agent Deck의 세션 관리가 "자동 운전"이라면, Conductor는 "함대 사령관"입니다. 더 높은 수준의 추상화 레이어로, Telegram / Slack / Discord를 통해 모든 AI 에이전트 세션을 원격으로 모니터링하고 오케스트레이션할 수 있습니다.
5분 만에 Telegram 모니터링 구축
# 1. @BotFather를 통해 Telegram Bot 생성, 토큰 획득
# 2. @userinfobot을 통해 본인 user ID 획득
# 3. 원클릭 설정 마법사 실행 (conductor, bridge daemon, heartbeat 자동 설정)
agent-deck conductor setup work --description "Work fleet"
# 4. conductor 세션 시작
agent-deck session start conductor-work
# 5. Telegram에서 bot에게 /status 전송
이 순간부터 모든 Agent Deck 세션이统一的 conductor 세션에 의해 모니터링됩니다:
- 일반적인 문제는 자동으로 처리
- 중요한 사항은 휴대폰으로 푸시 알림
- 대기 중인 작업이 "썩어서" 잊히는 일 없음
Watcher 설정: 외부 이벤트로 AI 에이전트 깨우기
직접 조회 외에도, Watcher를 설정하면 외부 이벤트(GitHub 이벤트, Gmail, ntfy 푸시, 미팅 알림 등)가 "초인종"을 울려 conductor를 깨울 수 있습니다. 구체적인 설정은 공식 Watcher 문서를 참조하세요.
6. Agent Deck vs 다른 대안 비교
| 기능 | Agent Deck | cc-switch | 기본 Terminal |
|---|---|---|---|
| 다중 에이전트 세션 관리 | ✅ 풀기능 TUI | ❌ 모델 전환만 | ❌ 수동 |
| Fork 세션 | ✅ 대화 이력 상속 | ❌ | ❌ |
| MCP 관리 | ✅ 시각화 TUI | ✅ CLI | ❌ 설정 파일 수동 수정 |
| Skills 풀化管理 | ✅ | ❌ | ❌ |
| MCP Socket Pool | ✅ 메모리 85%+ 절감 | ❌ | ❌ |
| 원격 모니터링 | ✅ Conductor | ❌ | ❌ |
| 크로스 에이전트 지원 | ✅ 전 에이전트 | ✅ 일부 | ❌ |
| Git Worktree 통합 | ✅ 완전 지원 | ❌ | ❌ 수동 |
| 상태별 필터 검색 | ✅ 4가지 상태 | ❌ | ❌ |
| 플랫폼 지원 | macOS / Linux / WSL | macOS / Linux | 전 플랫폼 |
7. 요약
Agent Deck이 해결하는 문제는 "어떤 AI 코딩 도구가 더 나은가"가 아닙니다 — 여러 AI 도구를 쓸 때, 서로 충돌 없이 협業하게 만드는 방법을 해결하는 것이죠.
핵심 가치 복습:
- 원스톱 컨트롤: 터미널 창 하나로 모든 AI 에이전트 관리, 탭 지옥 탈출
- Fork 세션: 기존 대화에서 새로운思路로 분기, 요구사항 다시 설명할 필요 없음
- 시각화 MCP/Skills 관리: 설정 파일 수동 수정 이제 그만
- MCP Socket Pool: 다중 세션에서 메모리 사용량 대폭 절감
- Conductor 원격 모니터링: Telegram / Slack으로 AI 에이전트 상태 수시로 파악
- Git Worktree 통합: 여러 에이전트가 같은 레포지토리에서 협업해도 충돌 없음
"AI 에이전트가 너무 많아졌다"는 문제를 겪기 시작했다면, Agent Deck은 현재 이 세그먼트에서 가장 성숙한 오픈소스 솔루션입니다. 게다가 업데이트 속도가 엄청나게 빠르고(v1.9.56 → v1.9.57 단 4시간 차이), 커뮤니티도 활발하며(PR #1408+),持续关注할 가치가 충분합니다.
관련 링크:
관련 글 추천: