TAU-HOME.COM
LOADING

AI Agent Session Center: 여러 터미널의 Claude Code·Codex 에이전트를 한곳에서 관리하는 대시보드

Claude Code, Codex, Gemini CLI 등 여러 터미널에서 구동되는 코딩 에이전트 세션의 승인 대기·입력 대기·작업 상태를 한눈에 모니터링하고 프롬프트 큐잉 및 복구를 돕는 오픈소스 로컬 대시보드 도구입니다.

tau · 2026년 10월 8일

#AI 에이전트 #Claude Code #Codex #개발 도구 #터미널 #생산성

AI Agent Session Center: 여러 터미널의 Claude Code·Codex 에이전트를 한곳에서 관리하는 대시보드

여러 터미널 창에서 다중 AI 코딩 에이전트를 동시에 실행할 때 발생하는 탭 전환 피로와 상태 파악 지연을 해소하기 위한 오픈소스 로컬 대시보드 프로젝트 'AI Agent Session Center'가 공개되었습니다.

다중 AI 코딩 에이전트 세션의 승인 대기 및 작업 상태를 한눈에 보여주는 AI Agent Session Center 로컬 웹 대시보드 화면

이미지 출처: Dan Kornas (@DanKornas) / coding-by-feng

최근 개발 현장에서는 기능 구현, 단위 테스트 작성, 리팩토링 등을 위해 Claude Code, Codex, Gemini CLI와 같은 CLI 코딩 에이전트를 동시에 서너 개씩 띄워두고 병렬로 작업을 진행하는 패턴이 보편화되고 있습니다. 그러나 어떤 세션이 사용자 승인을 기다리고 있는지, 어떤 작업이 완료되어 다음 명령을 대기 중인지, 또는 토큰 낭비 루프나 오류에 빠졌는지를 일일이 터미널 탭을 전환하며 확인하는 과정은 상당한 주의력 분산을 초래합니다.

AI Agent Session Center는 이러한 문제를 해결하기 위해 로컬 환경에서 구동되는 에이전트들의 상태와 터미널을 하나의 웹 대시보드(기본 포트 http://localhost:3333)로 집약하여 시각화하고 제어할 수 있도록 돕는 도구입니다.

훅 기반 비침습적 상태 감지와 저지연 스트리밍

AI Agent Session Center의 핵심 설계 원칙은 각 코딩 에이전트 바이너리나 소스코드를 임의로 변조하지 않고, 공식 지원되는 훅(Hook) 메커니즘을 통해 경량으로 상태를 수집하는 점입니다.

  • 원자적 설정 등록: CLI 도구 자체를 수정하지 않고, 설정 파일(예: ~/.claude/settings.json)에 원자적(atomic) 쓰기 방식으로 읽기 전용 훅만 안전하게 등록합니다.
  • 읽기 전용 메시지 큐 수집: 에이전트에서 발생하는 이벤트는 로컬 파일 기반 메시지 큐(/tmp/claude-session-center/queue.jsonl)를 거쳐 수집됩니다.
  • 3~17ms 저지연 웹소켓 전파: 수집된 세션 상태는 웹소켓(WebSocket)을 통해 브라우저 대시보드로 즉시 전송되며, 3~17ms 수준의 낮은 지연 시간으로 실시간 갱신됩니다.
  • 상태 구분 시각화: 각 세션을 작업 중(Working), 대기(Waiting), 승인 대기(Approval), 사용자 입력 대기(Input), 유휴(Idle), 종료(Ended) 등으로 명확히 분류하여, 사람의 개입이 필요한 세션을 즉시 식별할 수 있습니다.

단순히 전체 stdout 텍스트를 나열하는 것에 그치지 않고, 에이전트가 도구를 실행 중인지 또는 사용자의 승인·입력을 기다리고 있는지를 직관적으로 파악할 수 있도록 돕습니다.

xterm.js 터미널 제어와 자동 프롬프트 큐잉

웹 UI 상에서 각 에이전트 터미널을 직접 조작하고 작업 흐름을 유지할 수 있도록 인터랙티브 기능이 통합되어 있습니다.

  • xterm.js 터미널 에뮬레이션: 브라우저 내에서 각 에이전트 세션의 실제 터미널 화면을 확인하고 필요한 경우 직접 키보드 입력을 전달할 수 있습니다.
  • 스마트 프롬프트 큐: 에이전트가 긴 작업을 수행 중일 때 다음 지시사항을 미리 큐에 쌓아두면, 이전 작업 완료를 감지하여 자동으로 다음 프롬프트를 전송합니다.
  • 자동 비정상 종료 감지 및 복구: 세션이 예기치 않게 다운되거나 멈췄을 때 이를 감지하여 알림을 제공하고 재연결을 시도합니다.
  • 경량 로컬 런타임: 가벼운 로컬 백엔드로 동작하여 백그라운드 리소스 소모를 최소화합니다.

설치 및 시작하기

AI Agent Session Center는 Node.js 환경에서 npm 또는 pnpm을 통해 손쉽게 로컬에 설치하고 실행할 수 있습니다.

# 레포지토리 클론 및 의존성 설치
git clone https://github.com/coding-by-feng/ai-agent-session-center.git
cd ai-agent-session-center
pnpm install

# 대시보드 서버 실행 (포트 3333)
pnpm start

대시보드가 실행된 후 브라우저에서 http://localhost:3333으로 접속하면 자동으로 로컬 에이전트 세션 훅이 연결되어 실행 중인 에이전트 목록이 표시됩니다.

출처 및 참고 자료