IvanWng97/pixtuoid

pixtuoid – AI 코드 에이전트를 위한 터미널 기반 시각화 대시보드

무엇인가요 – pixtuoid는 Rust로 작성된 TUI(터미널 사용자 인터페이스)로, 실행 중인 AI 기반 코드 보조자(Claude Code, Codex, Antigravity 등)를 시뮬레이션된 사무실 내에 작은 픽셀 아트 '동료'로 변환합니다. 각 에이전트는 독자적인 책상, 색상 구분된 모니터, 토큰 사용량 메터, 애니메이션 행동(타이핑, 대기, 수면)을 갖습니다. 사무실은 여러 층으로 구성되며, 테마 장식, 날씨 효과, 배경 로피 음악, 그리고 돌아다니는 애완동물도 있습니다. 완전히 로컬에서 작동하며, 에이전트의 stdout/JSONL 전사본만 읽고, 데이터를 어디에도 전송하지 않습니다.

빠른 시작 (README에서)

설치 – 다음 중 하나의 패키지 매니저를 선택하세요:
```
# Homebrew (macOS, Linux, WSL2)
brew install pixtuoid

# npm (모든 OS)
npm install -g pixtuoid
```
(Cargo, 사전 빌드된 바이너리, .deb 패키지도 사용 가능.)
대시보드 실행:
```
pixtuoid
```
s 를 눌러 Sources 패널을 열고, 감시하고 싶은 코드 에이전트의 CLI(Claude Code, Codex 등)를 지정하세요. 다른 터미널에서 해당 에이전트를 시작하면, 1초 내에 픽셀 아트 캐릭터가 엘리베이터에서 걸어 들어옵니다.
README에 나와 있는 키보드 단축키(q 종료, p 일시정지, t 테마, Tab 대시보드 등)를 사용하여 층 전환, 테마 변경, 사운드 뮤트 등을 수행하세요.

핵심 기능 (README에 기재된 내용)

기능	보여주는 내용
다중 에이전트 사무실	각 에이전트는 독자적인 책상에서 작동하며, 필요 시 자동으로 새로운 층이 추가됩니다.
다층 사무실	`PageUp/PageDown` 또는 `↑/↓` 로 층 전환 – 뷰가 부드럽게 슬라이드됩니다.
사무실 공간	쿠비클, 라운지, 팬티 등 구분된 구역이 단순한 격자 구조가 아닌 개성 있는 레이아웃을 제공합니다.
애니메이션 캐릭터	에이전트는 타이핑, 입력이 필요한 경우 `?`를 들고, 수면(zzz), A* 경로 기반의 보행을 수행합니다.
팀 팔레트	셔츠/팬츠 색상은 현재 작업 디렉터리에서 유도되며, 동일한 리포지토리에서 온 에이전트는 동일한 톤을 공유합니다.
도구별 모니터 빛	책상 모니터는 편집 시 파란색, Bash 시 오렌지색, 읽기 시 시안색 등으로 빛나며, 사용 중인 도구를 즉각적으로 시각적으로 알 수 있게 합니다.
토큰 메터	책상 위의 종이 더미가 토큰 소비량(250K → 2M → 16M)을 시각화합니다. 마우스를 올리면 정확한 총합이 표시됩니다.
툴팁	에이전트 위에 마우스를 올리면 세션 길이, 도구 호출 횟수, 활성 시간 비율을 확인할 수 있습니다. 가구 위에 마우스를 올리면 이름을 확인할 수 있습니다.
에이전트 트리 대시보드	`Tab` 을 눌러 모든 에이전트의 접을 수 있는 트리 뷰를 열 수 있으며, 활동 상태에 따라 색상이 구분되고 호출 횟수도 표시됩니다.
사무실 애완동물	1층당 한 마리의 고양이 또는 개가 돌아다니며, 클릭으로 쓰다듬을 수 있습니다.
OpenClaw 게이트웨이 마스코트	사무실을 돌아다니는 게가 있으며, 그 움직임이 OpenClaw 게이트웨이의 상태를 시각화합니다.
사무실 분위기	낮/밤 주기, 날씨(비, 눈, 안개 등) 및 6가지 내장 색상 테마.
로피 사운드트랙	시간대와 활동에 따라 절차적으로 생성되는 음악. 타이핑, 문 열림, 프린터, 자판기 사운드 효과 포함.
플로팅 데스크탑 창	`pixtuoid floating` 을 실행하면, 터미널 외부의 테두리 없는 항상 위에 표시되는 창에서 사무실을 볼 수 있습니다.
훅 안전성	에이전트와 통신하는 작은 쉘은 항상 상태 0으로 종료되므로, 오작동하는 훅이 에이전트를 차단할 수 없습니다.

지원되는 AI 코드 도구

도구	플랫폼
Claude Code	macOS, Linux, Windows*
Codex CLI	macOS, Linux, Windows*
(그 외에도 Antigravity, DeepSeek-Reasonix, CodeWhale, Copilot CLI, Cursor CLI, Hermes Agent, OpenClaw, Grok Build, Kimi Code CLI 등)

도구 × OS의 전체 매트릭스는 사이트에 있으며, 새로운 도구 추가는 Source 트레이트 구현(또는 간단한 훅 디코더)과 sources.json 업데이트만으로 가능합니다.

작동 방식 (개요, README에서)

에이전트 CLI → 훅 쉘 – 각 지원되는 에이전트는 액션을 수행할 때마다 Unix 소켓 또는 Windows 이름 붙은 파이프를 통해 작은 '발화 및 잊기' 이벤트를 보냅니다.
에이전트 CLI → JSONL 전사본 – CLI는 또한 활동의 줄 단위 JSON 스트림을 출력합니다.
pixtuoid 코어 – 리듀서가 두 스트림을 소비하여 단일 사무실 상태 모델로 병합합니다.
렌더러 – 다섯 개의 Rust 크레이트가 이 상태를 터미널 내(또는 플로팅 창 내)에서 반블록 픽셀 아트로 렌더링합니다. 코어에서는 외부 터미널 UI 라이브러리를 사용하지 않습니다.
안전성 – 훅 쉘은 블로킹되지 않도록 설계되어 있으며, 심지어 멈춰도 에이전트는 계속 실행됩니다.

구성 및 확장성

구성은 ~/.config/pixtuoid/config.toml에 저장됩니다(처음 실행 시 생성됨). 모든 키는 선택 사항이며, CLI 플래그가 파일을 덮어씁니다.
t 키로 실시간으로 테마를 전환 가능. 6가지 내장 팔레트 제공.
사용자는 사용자 정의 스프라이트 팩 추가, 애완동물 이름 변경, 책상 용량 조정 등을 구성 파일로 조정할 수 있습니다.
새로운 에이전트 통합은 Source 트레이트 구현과 sources.json에 행 추가만으로 가능. 프로젝트에는 지원되는 세트를 고정하는 테스트도 포함되어 있습니다.

프라이버시 및 보안

로컬 전용 – 네트워크 트래픽 없음, 텔레메트리 없음.
에이전트 전사본은 읽기 전용으로 읽기만 함.
종속성 목록은 cargo-deny로 매일 감사됨.
훅 쉘 권한, 소켓 소유권 등 보안 고려사항은 SECURITY.md에 문서화됨.

누구에게 적합한가요?

여러 LLM 기반 코드 보조자를 병렬로 실행하고 상태를 한눈에 파악하고 싶은 개발자.
토큰 소비와 에이전트 건강 상태에 대해 재미있는 시각적 신호를 원하는 팀.
AI 에이전트가 작업하는 모습을 레트로 피크셀 아트와 함께 즐기고 싶은 사람.

라이선스

MIT – 개인 또는 상업적 사용에 무료.

결론: pixtuoid는 여러 AI 코드 에이전트를 애니메이션 픽셀 아트 사무실로 변환하는 완전 기능의 오픈소스 시각화 대시보드로, 개발자들이 데이터를 기계 외부로 전송하지 않고도 활동, 토큰 사용량, 도구 상태를 한눈에 파악할 수 있도록 합니다.