Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
agent-manager는 모든 AI 코딩 에이전트를 위한 개발자 워크플로우를 제공하는 로컬 터미널 앱입니다. 이 도구는 기존에 사용하던 다양한 구독 서비스 및 외부 도구들과 연결되어, 개발자가 보다 빠르고 통합된 환경에서 작업할 수 있도록 돕습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기<a href="LICENSE"><img src="https://img.shields.io/github/license/wainmann/agent-manager?style=for-the-badge&label=license&labelColor=1f2328&color=59636e" alt="licence"></a>
</p>  Claude Code, Codex, OpenCode, Grok, Gemini CLI, Antigravity CLI, Pi, Command Code, Hermes Agent, Muse Code, Oh My Pi, Cursor CLI, 그리고 Kiro CLI가 나란히 실행됩니다. 각 도구는 자체의 영구적인 tmux 세션에서 실행됩니다.agent-manager는 사용자가 이미 가지고 있는 CLI 위에 얇은 레이어(thin layer) 역할을 합니다. 각 세션은 설치된 도구를 그대로 실행합니다. 즉, 로그인 정보, 구독 정보, 설정 파일, MCP 서버, 그리고 해당 도구가 제공하는 모든 기능이 일반 터미널에서 작동하는 방식과 정확하게 유지됩니다.
어떤 에이전트가 완료되었는지 또는 멈췄는지 확인하기 위해 터미널 탭을 뒤질 필요 없이, 모든 세션은 실시간 상태와 함께 하나의 목록에 표시되며, 폴드(fold)하고 재정렬할 수 있는 프로젝트 트리로 그룹화됩니다. 연결(attaching)하지 않고도 이들 중 어느 곳이든 답변할 수 있습니다: space 키는 프롬프트를 해당 세션의 패널로 바로 보내거나, 선택된 그룹에 새 에이전트를 생성합니다. 비활성 세션은 v를 사용하여 자체 대화로 부활합니다. 그리고 ctrl+r은 에이전트가 변경한 내용에 대한 전체 파일 차이점 비교(full-file diff)를 구문 강조 표시와 함께 열어주며, 라인에 남긴 주석들은 C를 누르면 하나의 검토 프롬프트로 해당 에이전트의 패널로 돌아갑니다.
세션에서 f 키를 눌러 별도의 이름이 지정된 포크(fork)에서 대화를 계속할 수 있습니다.
마우스는 전체 매니저에서 작동합니다. 휠은 커서를 이동시키고, 세션을 클릭하면 해당 세션에 포커스를 맞추며, 행(row)을 클릭하거나 마우스 뒤로 가기 버튼을 누르면 이전 상태로 돌아갑니다. 핸들(Advanced 모드에서는 ⠿, Compatible 모드에서는 =)을 드래그하여 행의 순서를 재배치하거나 다른 그룹으로 이동할 수 있으며, 모든 행 끝에 있는 […]를 클릭하면 해당 행의 액션이 열립니다. 목록과 미리 보기 사이의 구분선은 드래그할 수 있으며, 메시지가 남아 있는 동안 키 범례(key legend)에서 messages를 클릭하면 해당 창이 열립니다. 포커스된 패널에서는 드래그를 통해 텍스트를 선택하고 복사할 수 있으며, 링크를 클릭하면 브라우저에서 열립니다. 설정(Settings)에는 네이티브 선택 기능을 다시 사용하고 싶은 터미널에 대한 마우스 토글 기능이 있습니다. 설정 → symbols는 기본값인 Advanced 기하학적 표시와 Compatible ASCII 표시 사이를 전환하며 실시간 미리보기를 제공합니다.
Mouse demo with the geometric marks used by Advanced mode: the wheel moves the cursor, clicks focus and leave sessions, the ⠿ handle drags rows, and […] opens row actions![Mouse demo with the geometric marks used by Advanced mode: the wheel moves the cursor, clicks focus and leave sessions, the ⠿ handle drags rows, and […] opens row actions](docs/demo-mouse.gif)
에이전트와 함께 사용하는 도구들은 같은 목록에 있습니다: T를 누르면 선택된 에이전트 아래 또는 선택된 그룹 내에서 빌드(builds), Git, 일회성 명령을 위한 셸(shell)이 열립니다. 에이전트는 다른 에이전트를 생성(spawn)하고, 메시지를 보내고, 작업이 완료될 때까지 기다릴 수 있습니다: 모든 MCP 지원 세션은 시작 시 이러한 도구들을 가지고 옵니다.
설정(Settings)에서 이름이 지정된 지침을 저장하고, 이를 새 세션 양식(New Session form), 빠른 프롬프트(quick prompt), 포커스된 세션, spawn --saved, send --saved, 또는 create_session에서 재사용할 수 있습니다. 저장된 프롬프트를 참조하세요.
아직 지원하지 않는 기능: 비용 추적(cost tracking).
이동하기: 설치 · 사용법 · 키(Keys) · Diff 검토 · 구성(Configuration) · 문서 사이트
상태 감지(Status detection)는 Claude Code, OpenCode, Codex, Grok Build, Gemini CLI, Antigravity CLI, Pi, Command Code, Hermes Agent, Muse Code, Oh My Pi, Cursor CLI, 및 Kiro CLI를 지원합니다. 각 도구의 실행(launch), 부활(revive), 포크(fork), 상태 규칙은 바이너리에 포함되어 배포됩니다 (Hermes, Antigravity, Oh My Pi, Cursor CLI, Kiro CLI는 포크 기능이 없음). 따라서 업그레이드를 하면 이 모든 도구의 현재 버전이 함께 업데이트됩니다 (설정 Configuration 참조). 목록에 없는 CLI는 기능 요청(feature request)입니다.
macOS 및 Linux에서 실행되며, psmux를 통해 네이티브하게 Windows에서도 작동하고, WSL2 내부에서도 사용할 수 있습니다.
brew install agent-manager
설치 시 누락된 경우 tmux도 함께 설치하며, Homebrew는 git에서 실행되므로 두 종속성 모두 처리됩니다. 이것은 소스에서 빌드되는 homebrew-core 포뮬러입니다. 미리 빌드된 바이너리의 경우, brew install --cask yoanwai/tap/agent-manager를 사용합니다.
scoop bucket add yoanwai https://github.com/YoanWai/scoop-bucket
scoop install yoanwai/agent-manager
이 버킷에 게시된 버전이 설치되며, Scoop은 psmux도 함께 설치합니다. 이 버킷은 자체적으로 업데이트되므로 최신 릴리스와 지연될 수 있습니다. 업데이트하려면 agent-manager를 종료하고 scoop update agent-manager를 실행하십시오. 전역 설치는 권한이 상승된 PowerShell에서 scoop update agent-manager --global을 사용합니다. 앱 내 업데이트기는 Scoop의 바이너리를 대체하는 대신 해당 지침을 표시합니다.
스크립트를 다운로드하고, 내용을 읽은 다음 실행하십시오. sh install.sh는 다운로드가 성공적으로 완료된 후에만 실행됩니다.
curl -fsSL -o install.sh https://raw.githubusercontent.com/wainmann/agent-manager/main/install.sh &&
sh install.sh
위의 복사본은 main 브랜치에 있는 스크립트입니다. 이 파일은 checksums.txt에는 포함되어 있지 않습니다. install.sh를 처음 첨부하는 릴리스 버전에서는 해당 파일을 checksums.txt에 나열합니다. 그렇게 된 후에는 첨부된 파일을 다운로드하고, gh에 로그인한 상태에서 스크립트가 실행되기 전에 이를 검증하십시오:
curl -fsSL -o install.sh https://github.com/wainmann/agent-manager/releases/latest/download/install.sh &&
gh attestation verify install.sh --repo wainmann/agent-manager &&
sh install.sh
위의 릴리스 URL은 해당 태그가 존재할 때까지 파일이 없으므로, 첫 번째 명령어가 그때까지 작동하는 방식입니다. 이전 버전의 경우 --repo wainmann/agent-manager 대신 --owner YoanWai --signer-repo YoanWai/agent-manager를 사용하여 검증합니다.
최신 릴리스 버전을 사용자의 플랫폼에 맞게 다운로드하고, 게시된 체크섬(checksums)과 비교하여 검증한 후 ~/.local/bin에 설치합니다. 그런 다음 tmux 3.1+ 및 git의 존재 여부를 확인합니다. macOS에서는 Homebrew를 제공하며, 누락된 경우 Homebrew 설치를 먼저 제안합니다. Linux에서는 apt, dnf, pacman, zypper, apk 또는 Homebrew 중 하나를 제공하며, 데스크톱 환경에서는 클립보드 및 알림 패키지도 제공합니다. 거절할 경우 해당 명령어를 출력합니다. 터미널 없이 실행하면 프롬프트를 건너뛰고 여전히 바이너리를 설치합니다. 다른 디렉토리에 설치하려면 AGENT_MANAGER_INSTALL_DIR를, 버전을 고정하려면 AGENT_MANAGER_VERSION을 설정하고, 의존성 프롬프트에 즉시 답변하려면 AGENT_MANAGER_INSTALL_DEPS=1을 사용하십시오 (건너뛰려면 =0). 다운로드된 아카이브가 gh attestation verify를 통과하지 못하면 설치를 거부하는 것이 AGENT_MANAGER_VERIFY_ATTESTATION=1입니다. 이 검사에 실패할 경우, 스크립트는 이전 릴리스에 필요한 --owner YoanWai --signer-repo YoanWai/agent-manager로 다시 시도하며, 두 가지 모두 실패했을 때만 중단합니다. gh가 없는 장치에 설치하려면 해당 변수를 설정하지 마십시오.
gh는 거부된 증명(rejected attestation), 누락된 로그인(missing login), 네트워크 오류(network error)에 대해 하나의 종료 상태를 사용하므로, 스크립트는 이들을 구분하려고 시도하지 않습니다.
먼저 읽을 파일 없이 실행하는 방법:
curl -fsSL https://raw.githubusercontent.com/wainmann/agent-manager/main/install.sh | sh
release에서 아키텍처에 맞는 Windows zip과 checksums.txt를 다운로드하세요. 추출하기 전에 SHA-256 값을 checksums.txt의 일치하는 줄과 비교해야 합니다. 수동 Windows 설치에는 PowerShell 명령어, 선택적 출처 검증(optional provenance verification), 그리고 종속성 설정(dependency setup)이 나와 있습니다.
스크립트를 다운로드하고, 읽은 다음, 실행하세요. 설치 프로그램은 해당 다운로드가 성공한 후에만 실행됩니다. Windows PowerShell 5.1에는 &&가 없으므로, 가드(guard)는 if ($?)입니다. 릴리스에서 install.ps1을 첨부하기 전까지는, 읽어야 할 파일은 main에 있는 사본입니다. 이 사본은 checksums.txt에 포함되어 있지 않습니다.
irm https://raw.githubusercontent.com/wainmann/agent-manager/main/install.ps1 -OutFile install.ps1
if ($?) {
Get-Content .
install.ps1
...```