AI Maestro: 멀티 에이전트 오케스트레이션 대시보드 안전 시작 가이드

Install

curl -fsSL aimaestro.sh | bash

누구에게 적합한가

Claude Code, Codex, Grok Build 등 여러 AI 코딩 에이전트를 동시에 사용하는 개발자로, 여러 터미널을 오가지 않고 하나의 웹 대시보드에서 이 에이전트 세션들을 통합 관리하고 싶은 분에게 적합합니다.
에이전트에 메모리 검색, 코드 그래프 조회, 에이전트 간 메시지 통신 같은 확장 기능을 갖추고 싶은 사용자에게도 적합합니다.
사용 전제 조건: 로컬 머신에서 셸 명령 한 줄로 설치를 완료해야 합니다. 앱 자체에 애플리케이션 계층 인증이 없기 때문에 반드시 신뢰할 수 있는 네트워크(예: Tailscale 내부망) 안에서만 사용해야 하며, 포트 23000을 신뢰할 수 없는 네트워크에 노출해서는 안 됩니다. 네트워크 경계를 보장할 수 없거나 이러한 보안 모델을 받아들일 수 없다면 사용하기 적합하지 않습니다.
공식 자료에서는 지원되는 운영체제 최소 요구 사항이나 에이전트 버전 요구 사항을 설명하지 않으며, 이 정보는 현재 알려져 있지 않습니다.

3분 만에 첫 시도하기

권장 기본 경로는 공식 문서에서 제시하는 원격 셸 설치입니다:

curl -fsSL aimaestro.sh | bash

전제 조건: 셸을 실행할 수 있는 머신 한 대, 그리고 사용자가 통제할 수 있는 신뢰할 수 있는 네트워크 안에 있어야 합니다.
설치: 터미널에서 위 명령을 실행합니다. 이 명령은 공식 remote-install 스크립트를 실행합니다. 주의: 네트워크에서 스크립트를 내려받아 실행하는 작업이므로, 설치 전에 해당 출처를 신뢰할 수 있는지 확인하세요.
설치 후: 실행하면 웹 기반 터미널 인터페이스를 제공하며, tmux를 통해 각 AI 에이전트 세션을 관리합니다(xterm.js 터미널 + node-pty + WebSocket 스트리밍 출력).
첫 시도는 저위험 작업을 추천합니다: 대시보드에서 기존 에이전트 세션을 열어 읽기 전용 분석을 한 번 수행하게 하는 것입니다. 예를 들어 특정 코드 파일의 구조를 요약하게 할 수 있습니다. 특정 에이전트가 어떤 작업을 지원하는지는 해당 에이전트 자체에 달려 있으며, 공식 자료에는 명시되어 있지 않습니다.
성공 신호: 브라우저에서 해당 에이전트의 터미널 세션 출력이 실시간으로 보이고, 에이전트가 분석 결과를 제시하면 성공입니다. 대시보드에서 여러 에이전트 세션이 동시에 표시된다면 오케스트레이션이 작동하고 있다는 뜻이기도 합니다.

공식 문서는 하나의 대시보드에서 여러 에이전트를 관리할 수 있다고 언급하지만, 다른 설치 방법은 설명하지 않으므로 이 가이드는 위의 공식 경로 한 가지만 다룹니다.

사용 사례

사례 1: 여러 에이전트 세션을 한곳에서 확인하기. 상황: Claude Code와 다른 에이전트를 동시에 실행 중이며, 같은 화면에서 두 세션을 보고 싶은 경우. 방법: 설치 후 실행하고, 브라우저에서 대시보드를 연 뒤 관리하려는 에이전트 세션을 연결합니다(공식 설명에 따르면 tmux로 세션을 관리합니다). 기대할 수 있는 결과: 하나의 웹 인터페이스에서 xterm.js 터미널을 통해 각 세션의 실시간 출력을 볼 수 있습니다.

사례 2: 에이전트에게 읽기 전용 코드 분석 수행시키기. 상황: 오케스트레이션 환경이 정상 작동하는지 확인하고 싶지만, 에이전트가 어떤 파일도 수정하지 않게 하고 싶은 경우. 방법: 대시보드에서 특정 에이전트에게 지시를 내립니다. 예: "src 디렉터리의 한 파일 구조를 분석하고 요약해 줘". 사용되는 기능: 대시보드의 터미널 세션 자체입니다. 메모리 검색이나 코드 그래프 조회를 호출하는지는 해당 에이전트에 로드된 스킬에 달려 있으며, 기본 로드 상태는 공식 자료에 설명되어 있지 않습니다. 기대할 수 있는 결과: 에이전트가 터미널에 분석 텍스트를 출력합니다. 파일 수정 같은 작업이 없다면 되돌릴 수 있는 관찰형 작업에 해당합니다.

사용 경계

네트워크: 앱은 기본적으로 0.0.0.0에 바인딩되며 애플리케이션 계층 인증이 없습니다. 보안 모델은 "네트워크가 곧 신뢰 경계"이며, 공식 문서는 Tailscale 같은 네트워크 경계와 함께 사용할 것을 요구하고, 포트 23000은 신뢰할 수 없는 네트워크에 노출해서는 안 된다고 명시합니다.
부작용과 확인 지점: 설치 시 원격 스크립트를 실행합니다. 에이전트 세션은 명령을 실행하거나 파일에 접근할 수 있으며, 구체적인 동작은 연결된 에이전트에 달려 있습니다. 이 앱이 에이전트 작업에 추가 제한을 두는지에 대해서는 공식 자료가 설명하지 않으므로, 알 수 없는 정보를 "무위험"으로 간주해서는 안 됩니다.
실행 환경: tmux와 WebSocket을 지원하는 브라우저가 필요합니다. 운영체제 요구 사항은 공식 자료에 명시되어 있지 않습니다.
공식 명시 제한: 애플리케이션 수준 인증이 없는 것은 설계상의 결정이며, 설정으로 바꿀 수 있는 옵션이라는 근거는 없습니다.
아직 확인되지 않은 사항: 지원되는 텍스트/에이전트 언어 범위, 지원 클라이언트 전체 목록, 업그레이드 및 제거 방법은 공식 자료에 모두 설명되어 있지 않습니다.