AionUi는 iOfficeAI가 오픈소스로 공개한 프로젝트로, GitHub에서 32,229 stars를 기록하고 있다. 'Agent Dashboard'라는 좁은 카테고리에서 이 정도 숫자는 결코 적지 않다. 핵심 컨셉은 단순하다. Claude Code, Codex, OpenCode, OpenClaw, Hermes 등 어떤 CLI Agent를 쓰든 전부 하나의 브라우저 패널에 모아 넣고, 스케줄링과 협업, 장시간 작업을 더해주는 것이다. TypeScript 풀스택으로 구현됐고, 로컬에서 명령어 한 줄이면 띄울 수 있다.
해결하려는 문제
CLI Agent가 점점 늘고 있다. Anthropic의 Claude Code, OpenAI의 Codex, Google의 Gemini CLI, 그리고 커뮤니티의 OpenCode, OpenClaw, Hermes까지. 각각은 터미널에서 돌아가는 작은 일꾼이다. 한두 개 쓰는 건 괜찮은데, 종류가 늘면 금방 엉망이 된다.
- 작업 큐가 누가, 어떻게 돌아가는지 한눈에 안 보인다
- 여러 Agent 사이에서 컨텍스트를 어떻게 넘길지 막막하다
- SSH를 끊거나 세션이 끝나도 죽지 않고 7×24로 걸어두려면 어떻게 해야 할지 모른다
- 여러 Agent를 한 프로젝트에 붙여서 협업시키는 방법이 없다
AionUi가 하고자 하는 건 명확하다. '각자 따로 노는 단신 Agent'들을 '팀 워크플로우'로 끌어올리는 것. 하나의 Dashboard가 모든 CLI Agent를 흡수하고, 스케줄링과 협업, 장시간 작업 능력을 입혀준다.
사용 방법
설치는 한 줄이다.
npm install -g aionui
그 다음:
aionui init # 초기화, 어떤 CLI Agent를 붙일지 인터랙티브하게 선택
# API key 설정 (Claude Code / Codex / OpenCode...)
aionui start # Dashboard 실행
# → 브라우저에서 http://localhost:3000 오픈
화면 구성은 이렇다. 왼쪽 사이드바에 모든 Agent 인스턴스가 '작업 자리'처럼 나열되고, 가운데에 작업 흐름, 오른쪽에 실시간 출력 로그가 뜬다. 최소 5분이면 처음부터 끝까지 돌려볼 수 있다.
새 CLI Agent를 붙이는 것도 가볍다. AgentProtocol 인터페이스를 구현하는 Adapter만 작성하면 된다.
import { AgentProtocol } from '@aionui/core';
export class MyAgentAdapter implements AgentProtocol {
async start() { /* CLI 프로세스 기동 */ }
async stop() { /* 정상 종료 */ }
async send(prompt: string) { return this.cli.stdin.write(prompt); }
async recv(): Promise<string> { return this.cli.stdout.read(); }
}
핵심 설계 철학은 한 문장으로 요약된다. Agent 자체를 만들지 않고, 관제 껍데기만 만든다. 이 절제 덕분에 32K stars 프로젝트임에도 불필요한 비대화를 피하고 있다.
동작 원리 (아키텍처)
세 개의 레이어가 각자 역할만 맡는다.
Agent Adapter 레이어 — CLI Agent마다 어댑터를 하나씩 만들고, AgentProtocol 인터페이스(start / stop / send / recv)로 통일한다. 이게 프로젝트의 핵심이다. CLI마다 다른 디테일을 다 숨기고, 위쪽 스케줄러 로직은 인터페이스하고만 대화한다.
Scheduler 레이어 — 작업 큐와 우선순위를 다루고, cron과 이벤트 트리거를 지원한다. Team 모드는 여러 Adapter를 DAG로 엮고, 데이터는 공유 workspace를 통해 흘러간다.
UI 레이어 — Electron + React 기반이고, 각 Agent 인스턴스를 '작업 자리'로 가상화한다. WebSocket으로 로그를 실시간 푸시한다.
개인적으로 높이 사고 싶은 건 Adapter 레이어의 설계 선택이다. 인터페이스만 정의하고 구현을 강제하지 않는다. stdin/stdout으로 통신할 수 있는 어떤 CLI Agent든 붙일 수 있고, 커뮤니티가 20개를 넘게 밀어넣은 이유가 바로 이것이다.
다른 Agent 프레임워크와 비교하면:
- LangChain Agents — 코드 작성 중심의 프레임워크. AionUi는 UI 껍데기라 코드 없이 조립한다.
- AutoGen — 다중 Agent 대화 프레임워크. AionUi는 LLM 직접 호출이 아니라 CLI 프로세스를 스케줄링한다.
- OpenHands — SWE Agent 그 자체. AionUi는 SWE Agent를 대체하는 게 아니라 조율한다.
- SillyTavern — 롤플레이 프런트엔드. AionUi는 엔지니어링 지향, 엔터테인먼트 지향이 아니다.
AionUi의 포지션은 독특하다. CLI Agent의 '프런트 데스크' 그 자체다.
좋은 점 / 아쉬운 점
좋은 점:
- 진짜 오픈소스(MIT)이고, TypeScript 풀스택이라 2차 개발이 쉽다
- 32K stars만큼 커뮤니티가 활발하고, issue 응답도 빠른 편이다
- 지원하는 CLI Agent 수가 20개 이상으로 가장 넓다
- Adapter 패턴이 깔끔해서 새 Agent 붙이는 비용이 낮다
아쉬운 점:
- README가 거의 비어 있고, 문서는 issue와 Discord에 많이 의존한다
- 본질은 '스위스 군용칼 껍데기'라, 진짜 지능은 아래쪽 CLI Agent에 다 있다
- 로컬 Node 환경이 필수라 순수 프런트엔드 배포는 어렵다
- 32K stars 급 프로젝트의 안정성 한계가 있고, 프로덕션 핵심 인프라로 쓰기엔 무리가 있다
직접 써봤다
저장소 클론해서 npm install까지 깔끔하게 끝났다. 콜드 스타트 40초. Claude Code와 Codex 두 Agent를 붙이고 작업을 몇 개 돌려봤다.
테스트 1: 단일 Agent 코드 생성
평균 응답 3.2초. CLI로 직접 쓸 때와 차이가 없다. 예상대로다. AionUi는 껍데기일 뿐이라 지연은 전부 포워딩에서 온다.
테스트 2: Team 모드로 협업 크롤러 작성
두 Agent가 협업해서 간단한 크롤러를 만들도록 시켰다. 완성도 70% 정도. 중간에 컨텍스트 전달을 수동으로 끼워줘야 했다. Team 모드는 아직 성숙 단계는 아니다. DAG 오케스트레이션의 의존 관계는 사용자가 직접 정리해야 한다.
테스트 3: 7×24 백그라운드 상시 구동
브라우저 탭을 닫아도 백엔드 작업이 계속 도는 것은 확인했다. WebSocket 재접속도 작업 손실 없이 잘 돌아간다. 이게 AionUi에서 가장 가치 있는 특성이라고 느꼈다.
성능 데이터: Agent 3개를 걸어두니 RAM이 1.8GB까지 올라갔다. Electron + Node + CLI 자식 프로세스 3개를 동시에 돌리는 거라 어느 정도 예상한 수치지만, 오래된 노트북에는 가혹하다.
이런 사람에게 추천
쓸 만한 케이스:
- 팀에서 2개 이상의 CLI Agent를 동시에 쓰는 개발자 — 통합 뷰가 드디어 생긴다
- Agent 작업을 장시간(야간, 배치)으로 돌리고 싶은 개인 — 7×24 상시 구동은 진짜 니즈다
- 고객에게 'AI 팀 협업'을 보여주되 처음부터 쌓고 싶지 않은 스튜디오 — 터미널보다 Dashboard 데모가 압도적이다
안 맞는 케이스:
- CLI Agent를 딱 하나만 쓰는 사람 — 굳이 이런 게 필요하다
- SaaS 호스팅 버전을 원하는 사람 — 현재는 로컬/셀프호스트만 지원한다
- 안정성 요건이 프로덕션 수준인 환경 — 32K stars 프로젝트지 320K는 아니다
편집자 소견
AionUi 같은 'Dashboard for Agent' 프로젝트의 진짜 가치는 UI 자체가 아니라, 그것이 드러내는 시그널에 있다. CLI Agent의 사용 장벽은 이제 '능력'이 아니라 '운영'으로 이동했다. '쓸 수 있나' 대신 '어떻게 오래, 많이, 협업해서 쓸 것인가'가 질문이 됐다. 32K stars는 이 수요가 진짜라는 뜻이다. awesome-list 신드롬(README는 화려한데 issue는 텅 빈)이 아니다. AionUi는 오히려 정반대다. README는 엉망인데 issue에 진짜 사용자들이 올라오는 질문이 쌓여 있다.
개인적인 예측을 덧붙이면, 2026년 하반기에 비슷한 프로젝트들이 한 차례 정리될 가능성이 있다. Anthropic, OpenAI, Google의 자체 IDE 통합(Claude Code in VSCode, Codex CLI, Gemini CLI in Android Studio)이 '다중 Agent 스케줄링'을 공식 클라이언트 안으로 흡수할 가능성이 크다. 공식 클라이언트가 다중 Agent를 지원하기 시작하면, AionUi 같은 중립 스케줄러층의 존재 이유가 줄어든다.
반대로, 오픈소스 CLI Agent 생태계가 계속碎片化(fragmented) 된다면 — 각 모델사가 자기 CLI를 만들고 커뮤니티에서도 계속 새 CLI가 튀어나온다면 — AionUi 같은 중립 스케줄러는 오히려 살아남을 여지가 있다. 공식 클라이언트는 자기 Agent만 지원하기 때문이다. 중립 레이어만이 차별화 가치가 있다.
아직 모르는 부분이 있다. 32K stars 프로젝트의 contributor 분포를 자세히 보진 않았다. 기여자가 1~2명에 몰려 있으면 지속 가능성 의문이고, 10명 이상으로 분산돼 있으면 이번淘汰賽를 버틸 확률이 높다. 이건 더 많은 데이터가 있어야 결론을 내릴 수 있다.