AI 에이전트, LLM 한도, 맥 상태를 책상 위 13개의 버튼으로.

Ulanzi D200을 공식 앱 없이 직접 제어하는 macOS 대시보드

English · 사용 가이드 · 기능 · 빠른 시작 · 기여하기

✨ 이런 분께 좋아요

여러 에이전트를 동시에 돌리면서 **"지금 누가 내 승인을 기다리지?"**를 자주 확인하는 분 → 결정이 필요한 칸이 노랗게 깜빡이고, 누르면 그 창으로 바로 이동해요.
Claude, Codex, agy를 번갈아 쓰면서 한도가 얼마나 남았는지 궁금한 분 → 남은 한도와 소진 페이스, 지금 쓰기 좋은 LLM을 알려줘요.
여러 대의 맥을 굴리는 분 → 맥마다 CPU, 메모리, 디스크, 건강 점수를 보고 버튼으로 바로 정리해요.

💡 펌웨어를 수정하지 않습니다. 장치는 Ulanzi 공식 펌웨어 그대로이고, agentdeck은 맥에서 도는 프로그램이에요. 끄고 Ulanzi Studio를 켜면 원래대로 돌아갑니다.

🛒 준비물

Ulanzi Stream Controller D200: 알리익스프레스 검색 결과에서 최저가나 마음에 드는 판매처를 골라 사면 돼요. Ulanzi 공식 스토어도 있어요.
- ⚠️ 상품명에 D200이 맞는지 꼭 확인하세요. 이름이 비슷한 D200X(노브 포함)와 D200H는 다른 모델이라 동작을 확인하지 않았어요.
macOS(Apple Silicon), Python 3.11 이상

🧩 기능

기능별 설정 방법은 **사용 가이드**에 그림과 함께 자세히 정리돼 있어요.

1 · LLM 남은 한도 Claude · Codex · agy의 5시간 / 주간 남은 한도, 시간 대비 페이스(과속 / 적정 / 여유), 지금 쓰기 좋은 LLM, 다음 리셋 _{→ 가이드: LLM 한도}
	3 · 에이전트 작업 현황 프로젝트별 에이전트 상태와 실행 수 🟨 결정 필요 · 🟩 완료 → 깜빡임, 누르면 그 창으로 이동 VS Code, Cursor, iTerm, Ghostty, 터미널 어디서 돌든 훅으로 수집 Herdr 사용자는 리드 pane 확대 같은 기능을 더 쓸 수 있어요 _{→ 가이드: 에이전트 현황}
워크트리 git 워크트리를 방치 · 정리 가능 · 오래됨 · 작업 중으로 분류. 길게 두 번 누르면 머지된 워크트리를 삭제하거나 리드 에이전트에게 정리를 요청해요. _{→ 가이드: 워크트리}
	4 · 머신 · 기기 상세 여러 맥의 CPU · 메모리 · 디스크 · 외장 드라이브와 Mole 건강 점수. 컴퓨터를 누르면 상세 페이지에서 빌드 산출물 정리 · 휴지통 비우기를 할 수 있어요. _{→ 가이드: 머신}
5 · 뽀모도로 칸 10개가 마지막 칸부터 거꾸로 비워지는 타이머. 끝나면 깜빡임과 맥 알림으로 알려줘요. _{→ 가이드: 뽀모도로}
	6 · 주식 히트맵 HeatTab처럼 한국 주식을 등락률 색으로 보여줘요(상승 빨강 · 하락 파랑). 코스피·코스닥 상위, 업종 등락, 내 포트폴리오, 관심 업종, 환율·유가·금·금리를 가운데 버튼으로 전환하고, 칸을 누르면 HeatTab 새 탭이 열려요. _{→ 가이드: 주식 히트맵}
7 · 어항 화면보호기 덱 전체를 하나의 어항으로 써요. 물고기·복어·해파리·게·거북이·문어·상어가 칸을 넘나들며 돌아다니고, 칸을 누르면 그 자리에 먹이가 떨어져요. 한동안 안 쓰면 자동으로 켜지고, 알림이 오면 알아서 빠져나와요. _{→ 가이드: 어항}

🚀 빠른 시작

git clone https://github.com/jakeparkcolde/agentdeck.git
cd agentdeck
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
cp config.example.json config.json
.venv/bin/python dashboard.py            # Ulanzi Studio 는 먼저 종료!

다음 단계	명령
로그인할 때 자동 실행	`./scripts/install-launchd.sh`
에이전트 현황 켜기 (IDE·터미널 상관없음)	`python3 scripts/install-hooks.py`
화면 언어 바꾸기	`config.json`의 `"ui_lang": "ko"` 또는 `"en"`

처음이라면 **사용 가이드**를 따라 하세요. 준비부터 기능별 설정, 문제 해결까지 순서대로 정리돼 있어요.

🎛 조작

버튼	동작
◀ / ▶	페이지 이동
가운데 짧게 / 길게	즉시 갱신 / 밝기 변경
깜빡이는 칸	해당 에이전트로 이동하고 알림 확인
🔴 삭제·정리	길게 1번 → 빨간 확인 대기 → 10초 안에 한 번 더 길게

🔧 동작 원리

flowchart LR
    subgraph Mac["이 맥 (launchd 상주)"]
        D[dashboard.py] -->|HID 1024B 패킷<br/>아이콘 ZIP · 밝기| DEV[(Ulanzi D200<br/>공식 펌웨어)]
        DEV -->|버튼 이벤트| D
        HK[Claude Code · Codex 훅] -->|세션 상태 파일| D
        D --- U[LLM 한도]
    end
    D -->|SSH| S[다른 맥들<br/>훅 상태 · Herdr · 워크트리 · Mole]

버튼 13개 아이콘(196×196)과 넓은 칸(458×196) 이미지를 ZIP으로 묶어 한 번에 보내요. 아이콘 이름에 내용 해시를 써서 바뀐 칸만 다시 그려집니다.
프로토콜은 redphx/strmdck와 jcalado/companion-surface-d200의 분석을 바탕으로 구현했어요.

⚠️ Codex와 agy 한도 조회는 공식 문서가 없는 내부 API를 씁니다. 언제든 바뀌거나 막힐 수 있으니, 각 서비스 약관을 확인하고 본인 책임 아래 사용하세요.

🗺 로드맵

훅 방식 에이전트 수집 (VS Code · Cursor · 터미널)
화면 문구 한국어 / 영어
일정 · 할 일 페이지 (다음 회의 카운트다운, 할 일 체크)
PR / CI 상태 페이지
페이지 플러그인 구조 (코드 수정 없이 페이지 추가)

아이디어가 있으면 기능 제안으로 알려주세요.

🤝 기여하기

새 페이지, 데이터 소스, 번역, 버그 제보 모두 환영해요. 장치가 없어도 demo.py로 화면을 그려보며 작업할 수 있어요.
자세한 방법은 **CONTRIBUTING.md**를 참고하세요.

🙏 크레딧

D200 프로토콜: redphx/strmdck (MIT) · jcalado/companion-surface-d200
맥 정리: tw93/Mole · 에이전트 터미널: Herdr
배너 배경 이미지는 OpenAI Codex 이미지 생성으로 만들었어요.

agentdeck은 Ulanzi, Anthropic, OpenAI, Google과 관계없는 비공식 프로젝트입니다.

📄 라이선스

MIT

✨ 이런 분께 좋아요

🛒 준비물

🧩 기능

1 · LLM 남은 한도

3 · 에이전트 작업 현황

워크트리

4 · 머신 · 기기 상세

5 · 뽀모도로

6 · 주식 히트맵

7 · 어항 화면보호기