AI 에이전트를 한눈에, 책상 위에서.

AgentDeck은 사용자의 AI 에이전트들을 하나의 로컬 대시보드로 모아줍니다. 어떤 에이전트가 작동 중인지, 사용자 입력을 기다리고 있는지, 아니면 완료되었는지 프로젝트와 도구 전반에 걸쳐 확인할 수 있습니다. 살아있는 아쿠아리움처럼 상태를 관찰하고, 타임라인을 따라가며, 사용량 제한을 한눈에 파악할 수 있습니다. Mac이나 터미널만 단독으로 사용하거나, 태블릿, Stream Deck, E-ink 리더기 또는 작은 데스크 디스플레이를 추가하여 사용할 수 있습니다.

2026년 9월 28일에 촬영됨. 전체 책상을 확인하세요.

이미 가지고 있는 것부터 시작하세요. 추가 하드웨어는 필요 없습니다.
Mac이나 터미널만 단독으로 사용하다가, 책상에 맞는 디스플레이를 추가할 수 있습니다.

시작하기 → · 보기 선택 ↓ ·
하드웨어 데스크 투어 시청

▶ 아쿠아리움 데모 시청
·
🌊 프로젝트 웹사이트
·
디바이스(Devices)
·
실시간 미리보기(Live preview)
·
디자인 시스템(Design system)

하나의 로컬 데몬이 이 화면들과 세션을 연결하고 제어합니다. 하나만 선택하거나 여러 개를 함께 사용할 수 있습니다. 이미지를 클릭하면 전체 크기로 볼 수 있습니다.

Stream Deck + 실시간 세션 키 및 물리적 컨트롤을 손끝에서. 설정 가이드 → |
터미널/TUISessions, 브라유 아쿠아리움, 사용량, 타임라인. 추가 하드웨어 불필요. 설정 가이드 → |
iPad 태블릿에 네이티브 컴패니언 대시보드를 제공합니다. iPhone에서도 이용 가능합니다. 설정 가이드 → |
안드로이드 태블릿 책상 위에 전용 대시보드를 배치할 수 있습니다. 설정 가이드 → |
Ulanzi D200H 물리적 세션 키. D200X LCD 키도 지원됩니다. 설정 가이드 → |
안드로이드 E-ink 리더 작업 옆에 조용한 세션 뷰를 제공합니다. 설정 가이드 → |

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
Round AMOLEDA circular ESP32 디스플레이 (수족관 및 사용량 게이지 포함). 설정 가이드 → |
TRMNL 7.5인치 A 대형 E-ink 상태 보드 (AgentDeck 펌웨어 구동). 설정 가이드 → |
LilyGo T-EmbedA 로터리 다이얼이 있는 소형 세션 디스플레이. 설정 가이드 → |
LilyGo T-Display-S3-ProA 세션 및 사용량을 위한 작은 터치 디스플레이. 설정 가이드 → |
LilyGo EPD47A 포커스 작업 및 사용량을 보여주는 그레이스케일 E-ink 패널. 설정 가이드 → |
ESP32 IPS 3.5인치 A 세션 및 사용량 패널이 있는 소형 수족관. 설정 가이드 → |

Divoom Pixoo64A 64 × 64 픽셀 아트 수족관. 설정 가이드 → |
Ulanzi TC001 넓은 LED 시계 디스플레이에 걸친 에이전트 생물들. 설정 가이드 → |
Divoom Timebox MiniAgent가 작은 11 × 11 픽셀 디스플레이에 표시됨. 설정 가이드 → |
iDotMatrix 에이전트를 보여주는 32 × 32 LED 뷰. 설정 가이드 → |

모바일 앱과 하드웨어는 컴퓨터의 데몬(daemon)에 연결됩니다. 제어는 세션이 지원되는 제어 경로를 노출할 때 사용할 수 있으며, 다른 표면에는 상태가 표시됩니다. D200X 인코더 제한을 포함하여 모델별 기능은 하드웨어 호환성 매트릭스를 참조하십시오.

Mac에서는 추가 하드웨어가 필요하지 않습니다. 아래에서 네이티브 앱의 작동 모습을 확인하세요.

Mac, iPhone/iPad 및 Android LCD 장치에서 익숙한 대시보드 또는 네이티브 3D 수족관을 선택할 수 있습니다. 각 세션은 생명체가 되며; 그 활동은 움직임을 변화시키고 주변 물고기들은 반응합니다. 모바일에서는 빈 물을 탭하여 패널을 숨기고 더 가까이 이동할 수 있습니다. 다시 탭하면 돌아옵니다. 기존 설정은 유지됩니다.

데모는 실제 네이티브 앱에서 가상의 코딩 작업을 따릅니다: 에이전트들이 참여하고, 코드를 편집하며, 테스트를 실행하고, 권한을 기다린 후 완료합니다. 개인 작업 공간 데이터는 표시되지 않습니다. 고해상도 스토리 또는 하드웨어 데스크 투어를 시청하세요.

1.8.0 쇼케이스의 새로운 기능: Hermes Agent가 다른 에이전트들과 함께하며 GitHub CI 동료들이 체크를 기다리며 세션 주위를 맴돕니다. 가상의 활동으로 구현된 네이티브 iPad 시뮬레이터에서 이를 확인할 수 있으며, 이전 소개 및 하드웨어 사진은 계속 이용 가능합니다.

새로운 시나리오 보기 · CI 대기 · 체크 완료

병렬 작업 추적. 세션 이름, 현재 사용 도구, 그리고 공유 타임라인이 각 에이전트가 무엇을 하고 있는지 설명해 줍니다. 협업 기능은 보고된 서브에이전트, 작업 관계, 그리고 최근 작업 기록을 보여줍니다.
필요할 때 알림 받기. 권한 및 입력 요청이 눈에 띄게 표시됩니다. 세션에서 실제 제어 경로를 제공하는 경우 지원되는 표면(surface)에서 답변하거나 개입할 수 있으며, 그렇지 않은 경우 프롬프트는 보기 전용입니다.
사용 현황 가시화. 연결된 공급자가 사용 데이터를 제공하는 위치에 Claude, Codex, z.ai/GLM 게이지가 나타납니다. 에이전트의 정체성과 모델 공급자는 별도로 유지됩니다.
디스플레이 선택. 3D 장면은 최대 여덟 개의 전경 거주자(foreground residents)를 읽을 수 있도록 유지하며, 로스터는 모든 세션을 보관합니다. E-ink는 정적 렌더링 배경과 절제된 움직임을 사용하고; 컴팩트 패널은 집중된 레이아웃을 유지합니다.

추가 하드웨어 불필요. 네이티브 대시보드를 선택하거나 터미널 경로를 이용할 수 있습니다.

App Store에서 설치하세요. Mac 앱에는 자체 데몬이 포함되어 있어 Node.js가 필요 없습니다. 설정(Settings)에서 에이전트 통합을 활성화한 다음, 평소처럼 에이전트를 실행하세요. iPhone/iPad는 네트워크상의 AgentDeck 데몬과 페어링됩니다.

macOS 26 이상 또는 iOS/iPadOS 17 이상이 필요합니다. Apple 가이드를 참조하세요.

macOS 15+, Windows 11, 또는 Linux에서는 Node.js 22, 24, 또는 26 및 지원되는 에이전트가 필요합니다.

npx @agentdeck/setup
agentdeck daemon install # 후크를 새로고침하고 관찰 시작
claude # 또는: codex · opencode · kiro-cli

다른 터미널에서:

agentdeck dashboard # 라이브 세션, 수족관(aquarium), 사용량, 타임라인

Mac 앱은 또한 Claude 구독 게이지 및 ADB 장치 지원을 포함한 추가 통합을 위해 CLI 데몬에 연결할 수도 있습니다.
기능 비교를 해보세요.
설정 문제의 경우 agentdeck diag agents를 실행하세요.

또는 설치 및 문제 해결 방법 보기.

기존 관리 세션 및 원격 연결

agentdeck claude,
agentdeck codex,
agentdeck opencode,
그리고
agentdeck monitor
은 제거 예정일 없이 계속 작동합니다. 일반적인 로컬 세션은 정상 에이전트 명령을 사용하는 데몬을 사용해야 합니다. 관리 전용 원격 연결, --weight,
에이전트 인자 재정의, 그리고 터미널 조향 기능은 대체품이 검증될 때까지 사용할 수 있습니다. CLI 참조, 원격 연결 가이드, 및 마이그레이션 논의를 참고하십시오.

AgentDeck은 코딩 워크플로우를 넘어 확장되고 있습니다: Hermes Agent가 옵트인 프리뷰로 지원됩니다(표 참조). 아래 표는 현재 통합 목록과 각 항목이 어떻게 관찰되는지 보여줍니다.

에이전트	관찰 방식
Claude Code	라이프사이클 훅; 주요 지원 통합
Codex CLI	라이프사이클 훅 및 롤아웃 로그
Codex Desktop	macOS에서 관찰됨; Windows 검증 대기
OpenCode	옵저버 플러그인 및 네이티브 이벤트
Kiro CLI / IDE	스크립트 관찰; 지연, 유휴 상태 활동만 가능
Antigravity	CLI 데몬을 통한 수동적 관찰
OpenClaw	실험적 게이트웨이 통합
Hermes Agent	프리뷰: 옵트인 옵저버 플러그인 (`agentdeck hermes-observer` 후 `hermes plugins enable agentdeck-observer`); 읽기 전용

에이전트를 정상적으로 실행하십시오. AgentDeck은 터미널 화면을 스크래핑하는 대신 네이티브 이벤트를 읽습니다. Kiro는 관리형 런처가 없으며, 격리된 Mac 앱의 경우 스크립트 관찰을 위해 일회성 폴더 권한 부여가 필요합니다. 자세한 설정 및 제한 사항: 구성(configuration), Apple 가이드, 및 게이트웨이 가이드를 참조하십시오.

사용하는 장치에 맞는 채널을 사용하십시오. 동일한 주요 버전을 가진 구성 요소들은 함께 작동합니다: 1.0 장치는 1.5 데몬에 연결할 수 있습니다. 마이너 버전과 패치 버전은 독립적으로 발전하므로, 모든 장치를 한 번에 업데이트할 필요는 없습니다.

Product	설치/업데이트	릴리스 태그
Mac · iPhone · iPad	App Store	`apple-v*`
...	`npm-v1.8.0`
Stream Deck / Mini / XL / Plus / + XL	Elgato Marketplace	`streamdeck-v*`
Ulanzi D200H / D200X LCD keys	Ulanzi Marketplace; D200X 인코더는 지원하지 않음	`ulanzi-v*`
ESP32 패널 및 TRMNL 7.5"	브라우저 플래셔 · 펌웨어 릴리스	`esp32-v*`

릴리스 작업, 2026-10-12: Android 1.9.0 (26)이 Google Play에서 사용 가능합니다(전체 배포, 13:10 KST에 게시됨) 그리고 서명된 GitHub APK로도 제공됩니다. LCD 및 e-ink에서의 안드로이드 안내 설정을 포함하여 npm과 ESP32 1.9.0이 검증되고 있습니다. 아래의 전달 상태는 각 채널의 게재 또는 제출 내용이 확인될 때까지 유효합니다.

전달 상태, 2026-10-06: Android 1.8.0의 서명된 APK와 Stream Deck/Ulanzi 1.8.0 패키지는 GitHub에 공개되어 있습니다. Google Play 1.8.0 (25)도 활성화되었습니다. Apple iOS/macOS 1.8.0은 App Store Connect에서 배포 준비 완료(10월 12일 확인); Apple 1.9.0 (각 플랫폼별 7901)은 검토 대기 중이며, 승인 후 자동 출시로 10월 12일에 제출되었으므로 아직 라이브 스토어 버전이 아닙니다. Ulanzi 1.8.0은 검토를 위해 제출되었습니다. Elgato 1.8은 공개되어 있습니다: Marketplace 페이지에는 2026-10-08에 출시된 Version 1.8이 표시됩니다(2026-10-11 확인). 마지막으로 검증된 공개 Ulanzi 버전은 여전히 1.6.0입니다. 네 개의 npm 패키지와 해당 latest 태그는 1.8.0으로 공개되어 있습니다. ESP32 1.8.0 펌웨어는 TTGO 의존성 수정이 Linux CI를 통과한 후 열두 개 보드에 대해 공개되었으며, 브라우저 플래셔는 검증된 1.8.0 이미지를 제공합니다.

현재 전달 확인 내용을 참조하십시오.

모바일 앱 및 하드웨어는 보조 표면입니다: 컴퓨터에서 데몬을 실행 상태로 유지하십시오. 지원되는 ESP32 보드는 첫 USB 플래시 후 Wi-Fi OTA를 제공하며, GitHub Android APK는 설정(Settings)에서 무선 업데이트를 제공합니다. Pixoo, TC001, Timebox, 그리고 iDotMatrix 설정은 장치 가이드에 포함되어 있습니다.

변경 로그 · 모든 릴리스 · 릴리스 정책

독립적인 통합(integration)은 자체 릴리스와 지원을 가집니다. 아래의 두 프로젝트 모두 커뮤니티 통합이며, 목록에 있다는 것이 검증된 호환성을 의미하지는 않습니다.

Pocket Daily Reader: portable-reader/v1 프로필을 사용하는 오프라인 우선 리더.
@houtacheng의 Bitfocus Companion 모듈: 세션 타일, 컨트롤 및 companion-control/v1을 통한 사용처.

기능(capabilities), 런타임 상태(runtime status), 통합 매니페스트(integration manifests), 그리고 준수 수준(conformance levels)은 Surface Protocol에서 확인하세요.

웹사이트부터 시작하세요 — puritysb.github.io/AgentDeck에는 렌더링된 장치 카탈로그, 라이브 렌더러 프리뷰, 디자인 시스템, 빌드 상태가 포함되어 있습니다.

pnpm install && pnpm build
pnpm -r --parallel dev
pnpm test

소스에서 빌드하기 · 테스트 · 빌드 상태. 코딩 에이전트는 AGENTS.md부터 시작해야 합니다.

버그 보고, 하드웨어 검증, 문서 수정 및 집중적인 풀 리퀘스트(pull requests)는 환영합니다. CONTRIBUTING.md를 읽고, 개인적인 취약점 보고에는 SECURITY.md를 사용하며, 행동 강령(Code of Conduct)을 따르세요. 에이전트 지원 작업에 대한 유지보자들의 검토 방식은 AI-assisted maintenance에서 확인하세요.

MIT — LICENSE 참조.

독립 프로젝트입니다. Anthropic, OpenAI, Google, Elgato, DIVOOM 또는 여기에 언급된 다른 제3자와는 관련이 없습니다. 모든 상표는 해당 소유자에게 속합니다. 전체 공지는 ATTRIBUTION.md에 있습니다.

AI 에이전트를 한눈에, 책상 위에서.

요약

핵심 포인트

기존 관리 세션 및 원격 연결

댓글

기존 관리 세션 및 원격 연결