Case study · macOS / AI agents
แอป menu bar บอกสถานะทีม AI: เห็นว่าใครทำอะไร โดยไม่ต้องเปิด dashboard
ผมมี dashboard ไว้ดูทีม AI agents อยู่แล้ว แต่เป็นหน้าเว็บที่ต้องเปิดทิ้งไว้ สิ่งที่อยากได้จริงคือเหลือบมองมุมจอแล้วรู้ว่ามีใครทำงานอยู่ และมีคำสั่งรอผมอนุมัติหรือเปล่า งานนี้จึงทำแอปบน menu bar ของ macOS โดยเริ่มจาก spec และ mockup ที่อนุมัติแล้ว จากนั้นให้ทีม AI สร้างตาม โดยผมเป็นผู้ตรวจรับ
- บทบาท
- เจ้าของงาน: ออกแบบหน้าจอ, เขียน spec และข้อจำกัด, ตัดสินใจระหว่างทาง และตรวจรับบนเครื่องจริง
- ช่วงเวลา
- 7 พ.ย. 2026 · ภายในวันเดียว · 3 commits
- เครื่องมือ
- Claude Code, Swift, SwiftUI + AppKit, Swift Package Manager, swift-testing
ภาพหน้าจอทุกภาพ render จาก view จริงของแอป แต่ใช้ข้อมูลเดโม ไม่มีงานหรือข้อความจริงของทีม · โค้ดเขียนโดย AI agents (Claude) ภายใต้ spec และการตรวจรับของผม · แอปใช้บนเครื่องผมเครื่องเดียว ไม่ได้แจกจ่าย
ปัญหา
Dashboard เดิมตอบได้ครบว่าใครมอบงานให้ใคร แต่ต้องเปิด browser ทิ้งไว้ และต้องสลับหน้าต่างไปดู ในวันทำงานจริงคำถามที่เกิดบ่อยกว่านั้นมีแค่สามข้อ
- ตอนนี้มี agent ทำงานอยู่ไหม กี่ตัว
- มีคำสั่งค้างรอผมกดอนุมัติหรือเปล่า
- server ของ dashboard ยังทำงานอยู่ไหม
คำถามแบบนี้ควรตอบได้จากการเหลือบมองครั้งเดียว ไม่ใช่เปิดหน้าเว็บ
เริ่มจาก spec และ mockup
ก่อนให้ AI เขียนโค้ดสักบรรทัด ผมออกแบบหน้าจอทั้ง 5 แบบเป็น mockup แล้วอนุมัติ จากนั้นเขียน spec ที่ส่งให้ทีม AI ได้ทันที มีสามส่วนที่ทำให้งานจบในวันเดียวโดยไม่ต้องรื้อ
| ส่วนของ spec | เขียนอะไรไว้ | ช่วยอะไร |
|---|---|---|
| ข้อจำกัดที่ห้ามละเมิด | ห้ามแก้ server เดิม, ห้ามใช้ library ภายนอก, ต้อง build จาก command line ได้ | ถ้า server ไม่มีข้อมูลที่ต้องใช้ ต้องหยุดแล้วเสนอมาก่อน ไม่ใช่แก้เอง |
| ข้อเท็จจริงที่อ่านจากโค้ดแล้ว | endpoint, ชื่อ field, วิธียืนยันตัวด้วย token, พอร์ต | บังคับให้อ่านฟังก์ชันจริงก่อนใช้ชื่อ field ห้ามเดา |
| เรื่องที่ยังไม่ได้พิสูจน์ | แยกเป็นรายการ พร้อมบอกว่าถ้าไม่เป็นอย่างที่คิดจะทำอะไรต่อ | ทดสอบเรื่องเสี่ยงก่อน แล้วจดผลกลับเข้า spec ระหว่างทาง |
หน้าจอและสีทุกสถานะถูกกำหนดเป็นค่าตายตัว เช่น WORKING เป็นส้ม ACTIVE เป็นน้ำเงิน idle เป็นวงกลมเทาโปร่ง และใช้ชุดสีเดียวกันทุกหน้าจอ ทำให้ตรวจรับได้ด้วยการวางภาพเทียบกับ mockup
สมมติฐานที่ทดสอบก่อนสร้าง
สามเรื่องที่ถ้าผิดจะต้องเปลี่ยนแผน จึงให้ทดสอบเป็นขั้นแรก ก่อนสร้างหน้าจอ
| สมมติฐาน | ผลที่ได้ | ตัดสินใจต่อ |
|---|---|---|
API สรุปสถานะ (/api/brain) บอกชื่อ tool ที่ agent กำลังใช้ | ไม่บอก และมีแค่ active / idle ไม่มี WORKING | คำนวณงานที่เปิดอยู่ในแอปเองจาก event stream (SSE) แทนการแก้ server |
| Notification ของ macOS ใช้กับแอปที่ sign แบบ ad-hoc ได้ | ใช้ได้บน macOS 27.0.1 | เก็บ notification ไว้ตามแผน แจ้งหนึ่งครั้งต่อคำสั่งใหม่ |
"เปิดตอน login" (SMAppService) ใช้กับแอป ad-hoc ได้ | ใช้ได้ ไม่ต้องอนุญาตเพิ่ม | ไม่ต้องทำ LaunchAgent สำรอง |
อีกเรื่องที่เจอระหว่างทางคือ server อาจถูกเปิดไว้ก่อนจากที่อื่น ซึ่งแอปไม่รู้ token ผมเลือกให้แอปอ่าน token จากหน้า Workspace ที่ server ฝังไว้อยู่แล้ว และอ่านใหม่เมื่อได้ 403 แทนการทำโหมดดูอย่างเดียว เพราะปุ่ม Approve คือเหตุผลหลักที่มีแอปนี้
สิ่งที่สร้าง
- ไอคอนบน menu bar 4 สถานะ: ว่าง, มี agent ทำงาน (พร้อมตัวเลข), มีคำสั่งรออนุมัติ (จุดส้ม) และ server หยุด ทุกสถานะแยกกันได้แม้ดูแวบเดียว ทั้งบนพื้นสว่างและพื้นมืด
- การ์ดการ์ตูน: บอกว่า agent ตัวไหนกำลังทำอะไร เลือกฉากจากชื่อ tool ที่ใช้อยู่ เช่น Read เป็นฉากอ่าน, Edit เป็นฉากพิมพ์, Bash เป็นฉาก terminal มีปุ่ม ‹ › เลื่อนดูงานที่ทำพร้อมกัน
- อนุมัติจาก menu bar: คำสั่งที่รออนุมัติแสดงพร้อมไฟล์แนบ กด Approve หรือ Reject ได้ทันที และมี notification ของ macOS แจ้งเมื่อมีคำสั่งใหม่
- ดูแล server ให้เอง: ถ้ายังไม่มี server แอปจะเปิดให้ ปิดแอปแล้ว server ที่แอปเปิดเองจะหยุดตาม แต่ถ้า server ถูกเปิดจากที่อื่น แอปจะใช้ตัวนั้นโดยไม่ปิดหรือรีสตาร์ต
- ประหยัดทรัพยากร: ตอนแผงปิดอยู่ ดึงข้อมูลทุก 15 วินาทีเพื่ออัปเดตไอคอนอย่างเดียว ตอนเปิดแผงค่อยดึงทุก 5 วินาทีและต่อ event stream แอนิเมชันเล่นเฉพาะตอนเปิดแผง และหยุดนิ่งถ้าเปิด Reduce motion ไว้
Security
แอปนี้กดอนุมัติคำสั่งให้ AI ไปทำงานได้ จึงต้องดูแลเรื่อง token แม้จะใช้ในเครื่องเดียว
| เรื่อง | การจัดการ |
|---|---|
| Token สำหรับสั่งงาน server | สร้างครั้งเดียว เก็บใน Keychain ไม่เขียนลง log |
| การเชื่อมต่อ | คุยกับ 127.0.0.1 เท่านั้น ผ่านการตรวจ Host และ Origin ของ server เดิมโดยไม่ต้องผ่อนกฎ |
| ทดสอบปุ่ม Approve / Reject | ทดสอบกับ server ที่ชี้ไปโฟลเดอร์ชั่วคราว ไม่แตะคิวงานจริง |
| Log ของ server | เก็บใน ~/Library/Logs และหมุนไฟล์เมื่อเกิน 5 MB |
ปัญหาที่เจอและการแก้
| อาการ | สาเหตุ | การแก้ |
|---|---|---|
Build ไม่ผ่านทันทีที่ใช้ @State | ใน macOS 27 SDK @State เป็น macro ที่ต้องใช้ Xcode เต็มตัว แต่โปรเจกต์ build ด้วย Command Line Tools | ใช้ ObservableObject + @StateObject แทนทั้งโปรเจกต์ และจดเป็นกฎไว้ใน README |
เปิดแอปจาก Finder แล้วหา node ไม่เจอ | แอป GUI ไม่ได้ PATH จาก shell | หา node แบบเดียวกับ hook ของ dashboard: PATH → nvm alias → nvm เวอร์ชันใหม่สุด → path มาตรฐาน |
| Agent ค้างสถานะ WORKING นาน | งานที่ไม่มี event ปิดท้าย ถูกนับว่ายังเปิดอยู่ | งานที่เงียบเกิน 30 นาทีแสดงเป็น "ค้างอยู่" และไม่นับเป็น WORKING |
| พอร์ตชนกับโปรแกรมอื่น | มีโปรแกรมอื่นใช้พอร์ต 4317 อยู่ | อ่าน error จาก log มาแสดงในกล่องแดงของหน้า "Server หยุดอยู่" ทันที |
ผลลัพธ์
- เสร็จภายในวันเดียว จาก spec ถึงแอปที่ติดตั้งใช้งาน ราว 3,750 บรรทัด Swift
- Tests 28 ข้อ ผ่านทั้งหมด ด้วย swift-testing ใช้ fixture JSON และ SSE ที่เก็บจาก server ที่รันด้วยข้อมูลเดโม
- ไม่มี dependency ใช้แค่ SwiftUI + AppKit และไม่ได้แก้ server เดิมเลยสักบรรทัด
- ภาพหน้าจอสร้างซ้ำได้ด้วยคำสั่งเดียว แอปมีโหมด render ภาพจาก view จริงด้วยข้อมูลเดโม เมื่อแก้หน้าตา ภาพในเอกสารก็อัปเดตได้ทันทีโดยไม่ต้องจับภาพหน้าจอเอง
ข้อจำกัด
- ชื่อ tool ที่กำลังใช้มาจาก event stream แบบสดเท่านั้น เพิ่งเปิดแผงจะยังไม่เห็นจนกว่า agent จะเรียก tool ครั้งถัดไป
- Sign แบบ ad-hoc ทุกครั้งที่ build ใหม่ macOS จะถามสิทธิ์ Keychain อีกครั้ง
- ทำไว้ใช้เครื่องเดียว ไม่ผ่าน notarization และไม่ได้ออกแบบให้แจกจ่าย
สิ่งที่ได้เรียนรู้
- Mockup ที่อนุมัติแล้วกับ spec ที่ตรวจได้ ทำให้ AI สร้างของที่ตรงใจได้ในรอบเดียว และตรวจรับได้ด้วยการเทียบภาพ
- เขียนแยกว่าเรื่องไหน "รู้แล้ว" กับ "ยังไม่ได้พิสูจน์" แล้วทดสอบเรื่องเสี่ยงก่อน ช่วยกันการรื้องานกลางทาง
- การห้ามแก้ระบบเดิมเป็นข้อจำกัดที่ดี มันบังคับให้หาทางในฝั่ง client และไม่สร้างงานดูแลเพิ่มให้ระบบที่ใช้งานอยู่