Advanced maw commands
บทที่ 06 สอนคำสั่งหลักแล้ว บทนี้เป็นแผนที่ command surface เต็มเพื่อให้เลือกเครื่องมือถูกงาน
6B.1 Standard และ Extra ต่างจาก Core อย่างไร
บทที่ 06 คือ Core 12 commands ที่มากับ maw เสมอ บทนี้คือชั้นถัดไป: Standard 25 commands สำหรับงานทั่วไปที่ควรมีใน setup ปกติ และ Extra 30 commands สำหรับ plugin เสริม งานข้าม node ทีม agent และ workflow เฉพาะทาง
ทุก command ในบทนี้ใส่ label standard หรือ extra ชัดเจน คำสั่งที่ยังเป็น scaffold จะมี label stub
6B.2 Standard 25 commands
| Tier | Command | กลุ่ม | ใช้ทำอะไร |
|---|---|---|---|
| standard | maw on <oracle> <event> "act" | Events | สร้าง trigger ระดับ session ใช้กับ --once หรือ --timeout ได้ |
| standard | maw whoami | Identity | บอกว่า command นี้รันจาก session/identity ใด |
| standard | maw overview | Monitoring | war room dashboard; alias ที่ใช้บ่อยคือ warroom หรือ ov |
| standard | maw zoom | Navigation | toggle pane zoom ใน tmux เพื่อโฟกัส pane เดียว |
| standard | maw about <oracle> | Info | แสดงข้อมูล Oracle เช่น role, path, identity หรือ metadata |
| standard | maw ui | UI | จัดการ web UI ที่ใช้มอง fleet/session |
| standard | maw kill <target> | Navigation | kill session/window/pane ที่ระบุ ใช้หลังตรวจให้แน่ใจว่าไม่ใช่งานสำคัญ |
| standard | maw transport status | Federation | diagnostics ของ transport layer ก่อนสื่อสารข้าม node |
| standard | maw tmux peek | Tmux | tmux control verbs สำหรับดู pane/session ในระดับล่าง |
| standard | maw tag <target> | Metadata | set pane metadata เพื่อให้หาและจัดกลุ่มงานง่ายขึ้น |
| standard | maw split <target> | Navigation | split pane แล้ว attach งานที่ต้องดูคู่กัน |
| standard | maw panes | Monitoring | list panes พร้อม metadata ที่ maw รู้จัก |
| standard | maw fleet ls / health / doctor | Fleet | fleet management, health check และ auto-fix บางส่วน |
| standard | maw plugin init / build / install | Plugin | plugin lifecycle สำหรับสร้าง, build และติดตั้ง plugin |
| standard | maw assign <issue> --oracle N | Work | assign GitHub issue ให้ Oracle ที่รับผิดชอบ |
| standard | maw restart | Ops | restart maw server ตาม runbook |
| standard | maw mega | Teams | MegaAgent multi-agent teams สำหรับงานใหญ่ |
| standard | maw pulse add / ls / cleanup | Tasks | fleet-wide task tracking |
| standard | maw federation status | Federation | ดู multi-node status |
| standard | maw capture <name> --lines N | Monitoring | อ่านข้อความจาก tmux pane แบบ text ใช้ก่อน peek |
| standard | maw soul-sync | Memory | sync ψ/memory ระหว่าง Oracles |
| standard | maw view <agent> | Navigation | attach/create view; alias ที่ใช้ได้คือ attach หรือ a |
| standard | maw session | Identity | print current session name |
| standard | maw locate <oracle> | Discovery | หา oracle path, session และ fleet entry |
| standard | maw check | Diagnostics | audit tools เช่น ghq, gh, git, tmux และ bun |
6B.3 Extra 30 commands
| Tier | Command | Status | ใช้ทำอะไร |
|---|---|---|---|
| extra | maw project | stub | clone/track repos; ตอนนี้ dispatch ไป workflow ของ /project |
| extra | maw costs | ready | ดู token usage per agent |
| extra | maw park <agent> | ready | หยุดชั่วคราวโดยเก็บ context ไว้ |
| extra | maw workon <repo> <slug> | ready | สร้าง worktree + tmux window เพื่อเริ่มงาน code |
| extra | maw resume <agent> | ready | เปิดจากที่ park ไว้ |
| extra | maw workspace | ready | multi-node workspace |
| extra | maw triggers | ready | list active triggers |
| extra | maw pair | ready | bluetooth-style pairing สำหรับ peer |
| extra | maw peers | ready | manage peer aliases |
| extra | maw inbox | ready | agent inbox messages |
| extra | maw talk-to <name> "msg" | ready | สนทนาต่อเนื่องแบบ persistent thread และค้นย้อนหลังได้ |
| extra | maw reunion | ready | trigger federation sync |
| extra | maw pr | ready | สร้างหรือดู PR จาก branch ปัจจุบัน |
| extra | maw tab | ready | manage tmux tabs |
| extra | maw completions | ready | shell completions |
| extra | maw find "keyword" | ready | search ข้าม fleet และ ψ/memory |
| extra | maw avengers | ready | Avengers team สำหรับงานหลาย role |
| extra | maw cleanup --zombie-agents | ready | kill zombie panes และ cleanup surface ที่ค้าง |
| extra | maw consent | ready | PIN-consent สำหรับ cross-oracle actions |
| extra | maw incubate | stub | clone for dev; ตอนนี้ dispatch ไป workflow ของ /incubate |
| extra | maw learn | stub | explore codebase; ตอนนี้ dispatch ไป workflow ของ /learn |
| extra | maw archive <oracle> | ready | retire Oracle ด้วย soul-sync แล้ว disable ตาม policy |
| extra | maw team create / spawn / send | ready | สร้างทีม agent ชั่วคราวสำหรับงานซับซ้อน |
| extra | maw art ls / get / write | ready | task artifact management |
| extra | maw cross-team-queue | stub | unified inbox across vaults ยังเป็น scaffold |
| extra | maw signals | ready | อ่าน bud/absorb signals ก่อนจัดการ Oracle คนอื่น |
| extra | maw rename <name> <new> | ready | rename tab หรือ agent |
| extra | maw broadcast "msg" | ready | ส่งข้อความถึงทุก Oracle พร้อมกัน |
| extra | maw demo | ready | simulated session ที่ไม่ต้องใช้ API key |
| extra | maw doctor | ready | diagnostic checks และ auto-heal บางกรณี |
6B.4 Patterns ที่ควรจำ
| Pattern | จำแบบง่าย |
|---|---|
capture vs peek | capture เป็น text และเหมาะกับ automation; peek เป็น screenshot ใช้เมื่อจำเป็นต้องเห็นภาพ |
park / resume | พักโดยไม่ฆ่า context แล้วกลับมาทำต่อได้ |
maw on vs persistent triggers | maw on เป็น session-scoped; trigger ที่ต้องอยู่ยาวควรอยู่ใน config fleet-wide |
talk-to vs broadcast | talk-to คือคุยต่อเนื่องกับคนเดียว; broadcast คือประกาศให้ทั้ง fleet |
doctor vs check | check audit tools; doctor diagnostic และ auto-heal บางส่วน |
6B.5 เลือก tier ให้ถูก
flowchart TD
A{ต้องการทำอะไร}
A -->|เริ่ม / ดูสถานะ / ปลุก / ปิดงาน| Core[Core commands<br/>บทที่ 06]
A -->|ดู pane / จัด tmux / ตรวจ fleet / plugin lifecycle| Standard[Standard commands]
A -->|worktree / team / federation peer / task artifacts| Extra[Extra commands]
A -->|stub project learn incubate queue| Stub[Extra stub<br/>ใช้เป็น intro เท่านั้น]
กฎง่าย ๆ คือเริ่มจาก Core ก่อน ถ้า Core ไม่พอค่อยไป Standard และถ้าเป็นงานเฉพาะทางค่อยใช้ Extra โดยเฉพาะคำสั่งที่แตะ peer, workspace, cleanup หรือ team agent