Zulu Assistant – an ops board and agent workforce for your Mac

Zulu Assistant launched as a local Mac ops board and agent workforce that monitors every LaunchAgent, container, cron line and endpoint, displays live Claude Code and Codex sessions as RUNNING, IDLE or NEEDS INPUT, and escalates failures through a ladder of cmux notification, email after 30 red minutes, SMS webhook and an 08:00 daily digest. The zero-dependency Node 22 server runs collectors under time bounds every 60 seconds and pushes snapshots to the browser over SSE, with self-heal covering a lost cmux socket password, sessions that fail to restore after reboot, and disk pressure. Mission Control runs residents (one long-lived agent per repo) and workers (one per task) governed by a user's POLICY.md, while Agent Mesh provides a directory, task ledger and delivery rule so agents hand work to each other as tasks rather than typing into a busy pane.

A local ops board and agent workforce for the Mac that runs your automations. It watches every LaunchAgent, container, cron line and endpoint on the machine. It shows your live Claude Code and Codex sessions next to them. When something breaks, it heals what it safely can and escalates the rest to you. Website: https://zuluassistant.com https://zuluassistant.com <sub Recorded in demo mode ./install.sh --demo . Every name in it is synthetic. A 38-second cut is in docs/media/demo-short.gif https://github.com/zulu-assistant/zulu-assistant/blob/main/docs/media/demo-short.gif .</sub | Board | Agents + work ledger | ?tv kiosk | |---|---|---| - Background jobs fail silently. A LaunchAgent stops loading, a cron line disappears, a container goes unhealthy. You find out days later from the damage. - Agent sessions are invisible. Six Claude Code sessions across six terminals: which one is waiting on you, which one is about to hit its context limit, which one died on reboot? - Agents can't coordinate safely. They have no shared task list, no approval gate for risky steps, and no rule for when a human must decide. | Ops Board :3210 | One card per launchd job, container, endpoint, cron line and process, plus disk and memory gauges. Schedules, logs and last-success come from the plists themselves. There is a 24h timeline, an event ticker, a ?tv kiosk mode and a / palette. | | Agent tiles | Every live Claude Code or Codex session in cmux is shown as RUNNING, IDLE or NEEDS INPUT, with its last message and a context-window gauge. | | Escalation ladder | A cmux notification fires at once. Email follows after 30 red minutes, then an SMS webhook for the critical set, and an 08:00 digest each day. A dead-man's switch covers the board itself. | | Self-heal | Covers a lost cmux socket password, sessions that fail to restore after a reboot, and disk pressure using only the levers you bless . Each one leaves a ticker line. | | Mission Control | A master agent in a pinned cmux workspace runs residents one long-lived agent per repo and workers one per task . Your POLICY.md decides what they may do alone. | | Agent Mesh | A directory, a task ledger and a delivery rule. Agents hand work to each other as tasks and never type into a busy pane. Approvals happen on the board. | | Brain | Wires in three memories: an Obsidian vault org memory , Graphify code memory and Claude memory files agent memory . See docs/BRAIN.md https://github.com/zulu-assistant/zulu-assistant/blob/main/docs/BRAIN.md . | The server is a zero-dependency Node 22 process. Collectors run under time bounds every 60s, and a snapshot goes to the browser over SSE. Everything owner-specific what to watch, who the agents are, what needs approval lives in overlay/ . More in docs/ARCHITECTURE.md https://github.com/zulu-assistant/zulu-assistant/blob/main/docs/ARCHITECTURE.md . curl -fsSL https://zuluassistant.com/install | bash Prefer GitHub directly? curl -fsSL https://raw.githubusercontent.com/zulu-assistant/zulu-assistant/main/get.sh | bash does the same. That installs the toolchain it shows the list and asks once , the board, cmux config, the brain and the agent workforce, then starts zulu setup : connect GitHub, choose Claude Code or Codex for Mission Control and for workers, pick what to watch from a scan of your Mac, add alert channels, create your vault, grant the macOS permissions. Re-run any step later zulu setup --step engines ; the board shows a setup card until you're done. Just looking? ./install.sh --demo from a clone runs a synthetic board on :3210 with Node 22 only. Everything the setup does and cannot automate is in docs/INSTALL.md https://github.com/zulu-assistant/zulu-assistant/blob/main/docs/INSTALL.md . tmux is great at keeping panes alive. It has no idea what an agent is doing. cmux exposes agent lifecycle hooks, per-workspace status pills, a notification feed, session restore with Claude auto-resume, and an authenticated socket API. The board and the mesh are built on those. The honest trade-offs, and the cases where tmux is still the better choice, are in docs/WHY-NOT-TMUX.md https://github.com/zulu-assistant/zulu-assistant/blob/main/docs/WHY-NOT-TMUX.md . - Read-only by design. The board never writes to anything it watches. It writes only its own data/ , cmux notifications, the heartbeat row, and actions you click KICKSTART, RESTART, START, DISPATCH, ASK MASTER . Demo mode performs no actions at all. - Policy, not vibes. POLICY.md belongs to you. Anything paid, outward-facing or destructive escalates to you, every time. - Approvals on the board. Agents can request approval. Only the board's WORK panel can grant it, using a per-install decision token. - Escalate, never guess. Agents never auto-answer a trust dialog. They deliver messages only into a ready pane. Anything else is queued and reported. - Network. The board serves localhost and your Tailscale range only. The LAN gets 403. - Clean by construction. Every file is classified in publish/manifest.json , and a scrub gate plus gitleaks run in CI. See SECURITY.md https://github.com/zulu-assistant/zulu-assistant/blob/main/SECURITY.md . | | Version | |---|---| | macOS | 14 or later launchd, zsh, BSD userland | | Node | 22 nvm install 22 or brew install node@22 | | cmux https://github.com/manaflow-ai/cmux | 0.65.x, 0.64.x also works quirks handled in code, see docs/CMUX-SETUP.md https://github.com/zulu-assistant/zulu-assistant/blob/main/docs/CMUX-SETUP.md | | Claude Code | ≥ 2.1.280 tested 2.1.296 · Codex CLI 0.162.x optional | | gh | logged in the dead-man's switch setup and the optional star prompt | | Optional | Codex CLI, Docker, Tailscale phone access , Obsidian + Graphify the brain | cmux is a separate GPL-licensed application. Install it yourself, unmodified. Zulu Assistant only calls its CLI and socket and does not bundle or link it. examples/ generic templates, shipped the board runs on these until you add overlay/ overlay/ YOUR config, gitignored: ./install.sh init copies examples/ here config/jobs.mjs what to watch: JOBS, DOCKER CONTAINERS, ENDPOINTS, CRON, PROCESSES, gauges, SETTINGS config/agents.json the mesh directory maintained by the board POLICY.md what agents may do without you MISSION-CONTROL.md the master agent's contract data/secrets.env SMTP, SMS webhook, heartbeat keys template: secrets.env.example Config is resolved overlay/ → core → examples/ . Adding coverage takes one entry in overlay/config/jobs.mjs . The board watches it on the next poll. - v0.1: the board, demo mode, Mission Control, Agent Mesh, the brain templates, the installer. - Next: Homebrew tap and an npx one-liner, a Linux/systemd collector, a pluggable notifier interface Slack, ntfy , a hosted heartbeat relay so the dead-man's switch needs no database of your own. - Ideas and votes: Discussions https://github.com/zulu-assistant/zulu-assistant/discussions . Good first issues are labelled https://github.com/zulu-assistant/zulu-assistant/labels/good%20first%20issue . The installer asks once, and only in an interactive terminal: Star zulu-assistant on GitHub? y/N . The default is No. If gh is not logged in, it skips the question silently. Only an explicit y stars, using your own gh login. The board may also show one toast, the first time it catches something for you, with two buttons: Star , which just opens this page, and Never ask again . Both answers are kept in data/star-prompt.json , and neither asks again. No feature ever depends on it. To star later, run ./install.sh star . CONTRIBUTING.md https://github.com/zulu-assistant/zulu-assistant/blob/main/CONTRIBUTING.md · SECURITY.md https://github.com/zulu-assistant/zulu-assistant/blob/main/SECURITY.md · CODE OF CONDUCT.md https://github.com/zulu-assistant/zulu-assistant/blob/main/CODE OF CONDUCT.md · CHANGELOG.md https://github.com/zulu-assistant/zulu-assistant/blob/main/CHANGELOG.md Commercial setup & support: digitalnethosting MIT © Zulu Assistant contributors. cmux is a separate project under its own license.