NEW개발기 · 09.27블로그를 갈아엎었다
← 포트폴리오
운영 중since 2026.08.17

Agent Status Deck

Claude Code·Codex 세션 상태를 LCD 버튼 덱과 맥 앱에 띄우는 상태판

SwiftmacOS 앱Node.jsUlanzi D200HClaude Code 훅Codex

무엇인가

Codex와 Claude Code로 동시에 여러 작업을 돌리면, 어느 세션이 아직 생각 중이고 어느 세션이 답을 끝냈는지 창을 하나씩 열어 봐야 알 수 있었다. Agent Status Deck은 세션마다 버튼 하나를 배정해 Ulanzi LCD 버튼 덱에 상태를 색으로 보여 주고, 버튼을 누르면 그 세션 화면을 바로 연다. 같은 정보는 맥 앱과 메뉴 막대 알림으로도 볼 수 있다.

왜 만들었나

에이전트에게 일을 맡겨 두고 다른 일을 하다 보면, 답이 끝났는데도 모르고 지나가거나 승인을 기다리는 세션을 한참 뒤에야 발견하곤 했다. 화면을 뒤지지 않고 책상 위 버튼 색만 보고 다음에 손댈 세션을 고르고 싶었다.

어떻게 만들었나

로컬 세션 기록에서 제목과 프로젝트, 마지막 활동 시각을 읽고, 생명주기 훅이 들어오면 작업 중·입력 대기·완료 상태를 더 정확히 갱신한다. 진행 중은 파랑, 답변 완료는 빨강, 한 시간 넘게 쉬면 노랑, 오류는 보라다. 자동 모드는 마지막으로 답이 끝난 세션부터 버튼을 채워서, 방금 끝난 일이 늘 맨 앞에 온다. 맥 앱은 Swift로 만들었고, 다른 맥에는 압축 파일 하나로 설치된다. 카드 미리보기에 개인 경로가 보이는 화면은 가려서 공개했다.

배운 것

상태를 되돌리는 규칙이 가장 까다로웠다. 답변이 끝난 뒤에 늦게 도착한 도구 이벤트 때문에 완료 표시가 다시 진행 중으로 바뀌면 버튼을 믿을 수 없게 된다. 그래서 완료는 다음 프롬프트나 새 세션이 확인될 때까지 유지하도록 정했다.