Maw Js

maw
Multi-Agent Workflow — wake agents, talk across machines, see the mesh.

maw is a CLI for running multiple AI agents across machines. You wake
an agent in a tmux window, send it tasks, watch its screen, and see what
it cost — all from one terminal. One node or twenty; same commands. Built
on Bun and engine-agnostic — drives Claude Code,
Codex, Aider, and OpenCode alike.

Install
Versioning: maw-js uses CalVer — v{yy}.{m}.{d}[-alpha.{HHMM}] (e.g. v26.5.17-alpha.752). Migrated from SemVer alpha on 2026-04-18. Cutting a release? See CONTRIBUTING.md → Versioning. Background: CHANGELOG · umbrella #526.

Recovering from maw: command not found

If maw vanishes unexpectedly (see #531 — root cause: npm name collision, fixed in #557 via rename to maw-js), recovery paths:

1. One-shot reinstall: bun add -g github:Soul-Brews-Studio/maw-js
2. Self-heal command: bunx -p github:Soul-Brews-Studio/maw-js maw doctor — auto-detects + restores
3. Shell hook: source scripts/maw-heal.sh from your .bashrc / .zshrc — checks on every shell init

Defense-in-depth: maw update stashes the binary to ~/.bun/bin/maw.prev before any destructive bun remove and restores on retry-fail (#551). maw doctor remains useful if the binary disappears for other reasons (older alpha, manual bun remove, disk full, etc.).

Full runbook: docs/install-recovery.md.

Quick Start

Installing the UI

maw installs API-only. The React frontend ships separately from
Soul-Brews-Studio/maw-ui.

Quick install (recommended — requires gh auth)

Downloads dist.tar.gz from the maw-ui GitHub Release and extracts to the
active maw data dir (~/.maw/ui/dist/ by default today, or
$XDG_DATA_HOME/maw/ui/dist/ when MAW_XDG=1). Restart the maw server to
serve the new UI.

Manual install (no gh)

Build from source

Runtime paths and XDG…