Zulu Assistant는 Mac에서 실행되는 LaunchAgent, 컨테이너, cron 작업, 엔드포인트와 Claude Code·Codex 세션을 한곳에서 확인하고 관리하는 도구다. 문제가 생기면 안전하게 처리할 수 있는 항목은 자동 복구하고, 나머지는 사용자에게 알린다고 제작진은 설명한다.
Zulu Assistant 웹사이트에서 소개를 확인할 수 있다. 저장소에는 데모 영상과 38초짜리 짧은 데모가 있다. 데모는 ./install.sh --demo로 녹화했으며, 화면에 나오는 이름은 모두 임의로 만든 데이터다.
기능과 작동 방식
운영 보드는 각 launchd 작업, 컨테이너, 엔드포인트, cron 항목, 프로세스를 카드로 보여주며 디스크·메모리 상태도 표시한다. 일정, 로그, 마지막 성공 시각은 plist에서 가져온다. 24시간 타임라인과 이벤트 표시창, 키오스크 모드인 ?tv, 명령 팔레트인 /도 제공한다.
cmux에서 실행 중인 Claude Code와 Codex 세션은 RUNNING, IDLE, NEEDS INPUT 상태로 표시된다. 세션의 마지막 메시지와 컨텍스트 창 사용량도 볼 수 있다. 알림은 먼저 cmux 알림으로 전달되고, 30분 동안 문제가 해결되지 않으면 이메일을 보낸다. 중요 항목에는 SMS 웹훅을 사용하며 매일 08:00에 요약 알림도 보낸다. 보드 자체의 상태를 감시하는 데드맨 스위치도 포함한다.
자동 복구 기능은 cmux 소켓 암호 분실, 재부팅 뒤 복원에 실패한 세션, 디스크 공간 부족을 다룬다. 디스크 문제에는 사용자가 허용한 조치만 적용하며, 각 복구 시도는 이벤트 목록에 기록된다.
Mission Control은 고정된 cmux 작업 공간에서 마스터 에이전트를 실행한다. 마스터는 저장소마다 하나씩 상주 에이전트를 두고, 작업마다 별도의 작업 에이전트를 운용한다. 에이전트가 독자적으로 할 수 있는 일은 사용자가 설정하는 POLICY.md에 따른다. Agent Mesh는 에이전트 디렉터리와 작업 장부, 작업 전달 규칙을 제공한다. 에이전트는 다른 에이전트의 사용 중인 창에 직접 입력하지 않으며, 승인은 보드에서 처리한다.
Brain 기능은 조직 메모리용 Obsidian 저장소, 코드 메모리용 Graphify, 에이전트 메모리용 Claude 파일을 연결한다. 자세한 내용은 Brain 문서에서 확인할 수 있다.
서버는 의존성이 없는 Node 22 프로세스다. 수집기는 60초마다 시간 제한을 두고 실행되며, 스냅샷은 SSE를 통해 브라우저로 전달된다. 감시 대상과 에이전트, 승인 설정 등 설치별 구성은 overlay/에 둔다. 자세한 내용은 아키텍처 문서에 있다.
설치 조건과 안전 장치
설치 명령은 curl -fsSL https://zuluassistant.com/install | bash다. GitHub에서 직접 받으려면 curl -fsSL https://raw.githubusercontent.com/zulu-assistant/zulu-assistant/main/get.sh | bash를 사용할 수 있다. 설치 과정에서 도구 목록을 보여주고 한 차례 확인을 요청한 뒤, 보드와 cmux 설정, Brain, 에이전트 구성을 설치한다. 이어지는 zulu setup에서 GitHub를 연결하고 Mission Control과 작업 에이전트에 Claude Code 또는 Codex를 선택하며, Mac을 검색해 감시 대상을 고르고 알림 채널·저장소·macOS 권한을 설정한다. 설정 단계는 나중에 zulu setup --step engines처럼 다시 실행할 수 있다. 설치 과정과 자동화할 수 없는 항목은 설치 문서에 정리돼 있다.
설치 없이 살펴보려면 저장소를 복제한 뒤 ./install.sh --demo를 실행하면 된다. Node 22만으로 :3210에서 가상 데이터를 사용하는 보드를 실행하며, 데모 모드에서는 어떤 조치도 수행하지 않는다.
요구 사항은 macOS 14 이상과 Node 22다. 별도 애플리케이션인 cmux 0.65.x가 필요하며 0.64.x도 코드에서 일부 차이를 처리해 사용할 수 있다. Claude Code는 2.1.280 이상이 필요하고, 제작진은 2.1.296에서 테스트했다고 밝힌다. Codex CLI 0.162.x는 선택 사항이다. gh에 로그인해야 하며, Docker·Tailscale·Obsidian·Graphify도 선택적으로 사용할 수 있다. cmux는 자체 GPL 라이선스를 따르는 별도 프로그램으로, 사용자가 직접 설치해야 한다. Zulu Assistant는 cmux의 CLI와 소켓을 호출하며 이를 묶거나 링크하지 않는다. cmux 설정 문서에서 관련 내용을 볼 수 있다.
제작진은 보드가 감시 대상에 쓰기 작업을 하지 않는다고 설명한다. 보드가 쓰는 곳은 자체 data/, cmux 알림, 하트비트 항목과 사용자가 직접 누른 KICKSTART·RESTART·START·DISPATCH·ASK MASTER 조치로 한정된다. 유료·외부 공개·파괴적 작업은 매번 사용자에게 승인 요청을 보낸다. 에이전트는 신뢰 확인 창에 자동 응답하지 않으며, 준비된 창에만 메시지를 전달한다. 네트워크 접근은 localhost와 사용자의 Tailscale 범위로 제한하고, LAN 요청에는 403을 반환한다. 보안 관련 설명은 보안 문서에서 확인할 수 있다.
Zulu Assistant는 현재 v0.1에 보드, 데모 모드, Mission Control, Agent Mesh, Brain 템플릿, 설치 프로그램을 포함한다. 다음 단계로 Homebrew tap과 npx 설치 명령, Linux/systemd 수집기, Slack·ntfy 같은 알림 플러그인, 자체 데이터베이스가 필요 없는 호스팅 하트비트 릴레이를 계획하고 있다. 제안과 투표는 GitHub Discussions에서 받으며, 첫 기여에 적합한 이슈도 표시해뒀다.
관련 문서: 기여 안내 · 보안 · 행동 강령 · 변경 기록. Zulu Assistant 기여자들이 MIT 라이선스로 제공하며, cmux에는 별도 라이선스가 적용된다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요