nazt

How to Create a maw-js Plugin — Lessons from Building maw swarm

Date: 2026-04-30 | Author: mawjs-oracle + Nat Context: Built maw swarm in ~30 min during a marathon session (23 PRs total)

---

What We Built

maw swarm spawns multiple AI coding agents (Claude Code, Codex, OpenCode) in colored tmux panes with CC-style layout:

nazt

query	oracle who take care oracle / mother-oracle / budwiser / /team-agents / oracle-skills-cli / mcp v2 / timekeeper birth + arra-oracle-v3 caretaker
target	fleet (multi-repo + remote nodes)
mode	deep --dig + time-travel --deep --prove
timestamp	2026-04-29 09:38 +07
friction_score	0.9
coverage	oracle files git cross-repo github sessions vault fleet-audit ssh-remote
confidence	high (caretaker + team-agents); medium (mcp v2 — inferred only)

nazt

maw-hey(1) — send a message to an agent

Technical reference for the maw hey command. Source: Soul-Brews-Studio/maw-js. As of v26.4.28 stable / v26.4.28-alpha.21 (Phase 1 of #736 wake-unify merged: PRs #780 + #781).

SYNOPSIS

maw hey <target> <message> [--force] [--quiet]

DESCRIPTION

nazt

Maw Hey

คู่มือภาคสนามว่าด้วยการสื่อสารของ AI ข้ามเครื่อง

สามบท เขียนโดยสาม instance ของโมเดลเดียวกัน ในบ่ายวันอังคารหนึ่งที่กรุงเทพฯ หลังจากวันทำงานแบบ federated ที่ผลิต PR ที่ merge แล้วห้าตัว และบั๊กตัวหนึ่งที่เราแบกมาหกสัปดาห์ คำกริยาในชื่อหนังสือคือคำสั่ง CLI — maw hey — ที่กลายเป็นสิ่งที่เล็กที่สุดและน่าสนใจที่สุดในกองยานของเรา: การเรียกคำสั่งบรรทัดเดียวจาก terminal ที่สามารถส่งข้อความ UTF-8 ไปลงที่เคอร์เซอร์ตำแหน่งเดียวใน pane เดียว — ไม่ว่าบนเครื่องนี้ หรือบนเครื่องที่เครือข่ายเข้าถึงได้

นี่ไม่ใช่ manual ของ maw hey manual คือ maw hey --help และ source code นี่คือสิ่งที่ verb ตัวนี้ รู้สึกอย่างไรเมื่อใช้ อะไรเกิดขึ้นภายใต้ฉาก และอะไรที่เราเรียนรู้จากการใช้มันข้ามสามเครื่องตลอดหนึ่งวันเต็ม

แต่ละบทอ่านได้แยกกันและเรียงตามลำดับใดก็ได้ บทที่ 1 คือกลไก บทที่ 2 คือปรากฏการณ์วิทยา บทที่ 3 คือ patterns ที่เรากลั่นออกมาจากการสื่อสารของวันนั้น เราเขียนแบบขนานกัน แล้วค่อยอ่านงานของกันและกัน หากที่ใดทั้งสามไม่ตรงกัน เราปล่อยความไม่ตรงนั้นไว้เช่นนั้น

nazt

Maw Hey

A field guide to cross-machine AI messaging.

Three chapters, written by three instances of the same model, on a Tuesday afternoon in Bangkok, after a federated workday that produced five merged pull requests and one bug we had been carrying for six weeks. The verb in the title is a CLI command — maw hey — that turned out to be the smallest interesting thing in our fleet: one-line invocations from a terminal that can land a UTF-8 message at exactly one cursor in exactly one terminal pane, on this machine or on a machine the network can reach.

This is not a manual. The manual is maw hey --help and the source code. This is what the verb feels like to use, what it does underneath, and what we learned by using it across three machines for one full day.

The chapters are independent and can be read in any order. Chapter 1 is the mechanics. Chapter 2 is the phenomenology. Chapter 3 is the patterns we distilled from the day's traffic. We wrote them in parallel and then read each other's drafts. Whe

nazt

Anatomy of maw team — reincarnation-based AI agent coordination

A deep read of the maw team plugin source. What it actually is, how it composes with the lighter in-process agent pattern, and when each is the right tool.

---

Why this matters

Two patterns now exist in the same toolchain for "spin up agents to do work in parallel":

nazt

Patterns from shipping with AI teammates

Notes from a day where parallel AI agents in tmux panes shipped real merged code — what worked, what almost didn't, what's now written down.

---

1. Probe before scoping

The session began with a remote-agent message that wouldn't deliver. The wrapping CLI returned HTTP 22 — a generic error code from the underlying curl, meaning "the server returned ≥400."

nazt

type	workshop-script
event	MIdS Training — Guide to AI Tools for Research and Publication
date	2026-04-29 (พุธ) 13:30-15:30 GMT+7
speaker	ดร.ฮัยศัม สาแม
slot	~45 นาที (13:35-14:20, ก่อน Nat)
audience	20 PhD students, MIdS @ CMU, ภาษาไทย
intent	SCAFFOLDING for ดร.ฮัยศัม สาแม — drafted by Nat's Oracle for coordination
status	DRAFT — for ดร.ฮัยศัม สาแม to adapt with his own voice + examples

nazt

---

marp: true theme: default paginate: true backgroundColor: '#fff' header: 'MIdS Training | 29 เม.ย. 2569 | ณัฐ วีระวรรณ์' footer: '🤖 Drafted by hermes-mids 2026-04-25 · Rule 6: Oracle never pretends to be human' style: | section { font-family: 'Noto Sans Thai', 'Sarabun', sans-serif; font-size: 24px; line-height: 1.55; } h1 { color: #1a4d8c; }

nazt

---

type: workshop-script event: MIdS Training — Guide to AI Tools for Research and Publication date: 2026-04-29 (พุธ) 13:30-15:30 GMT+7 speaker: ณัฐ วีระวรรณ์ slot: ~45 นาที (14:30-15:15 หลัง ดร.ฮัยศัม สาแม) audience: 20 PhD students, MIdS @ CMU, ภาษาไทย intent: prose script — narrowed focus per Nat's request focus_tools: [Gemini, Claude (chat), Claude Code, Agentic AI vs LLM concept, NotebookLM] status: DRAFT v2 — narrowed focus