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 และการตรวจรับของผม · แอปใช้บนเครื่องผมเครื่องเดียว ไม่ได้แจกจ่าย

แผงสถานะตอน server ทำงาน: การ์ดการ์ตูน Dev-ไอ้เก่ง กำลังแก้ไฟล์ งาน 1 จาก 3, KPI 3 ช่อง, คิวรออนุมัติพร้อมปุ่ม Reject และ Approve, รายชื่อ agent 8 ตัวพร้อมสถานะ
คลิกไอคอนบน menu bar แล้วเห็นทั้งหมดในแผงเดียว: ใครกำลังทำอะไร, ตัวเลขรวม, คำสั่งที่รออนุมัติ และสถานะ agent ทั้ง 8 ตัว
แผงสถานะตอน server หยุด: ปุ่มเริ่ม server และกล่องแดงแสดง error EADDRINUSE ล่าสุด พร้อมลิงก์ดู log
ถ้า server ไม่ทำงาน แผงจะเปลี่ยนเป็นหน้านี้ กดเริ่มได้ทันที และเห็น error ครั้งล่าสุดโดยไม่ต้องไปเปิด log

ปัญหา

Dashboard เดิมตอบได้ครบว่าใครมอบงานให้ใคร แต่ต้องเปิด browser ทิ้งไว้ และต้องสลับหน้าต่างไปดู ในวันทำงานจริงคำถามที่เกิดบ่อยกว่านั้นมีแค่สามข้อ

คำถามแบบนี้ควรตอบได้จากการเหลือบมองครั้งเดียว ไม่ใช่เปิดหน้าเว็บ

เริ่มจาก 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 คือเหตุผลหลักที่มีแอปนี้

สิ่งที่สร้าง

ไอคอน 4 สถานะบนพื้นสว่างและพื้นมืด: Idle, Working พร้อมเลข 3, Pending approval มีจุดส้ม และ Server stopped มีขีดทับ
ไอคอนบน menu bar: ว่าง / มี agent ทำงาน 3 ตัว / มีคำสั่งรออนุมัติ / server หยุด
ฉากการ์ตูน 8 ฉาก: พัก, อ่าน, แก้ไฟล์, รันคำสั่ง, ค้นเว็บ, มอบงาน, เสร็จ และล้มเหลว
8 ฉากตามสิ่งที่ agent กำลังทำ: พัก, อ่าน, แก้ไฟล์, รันคำสั่ง, ค้นเว็บ, มอบงาน, เสร็จ และล้มเหลวหรือค้าง สีพื้นการ์ดเปลี่ยนตามฉาก
หุ่นยนต์ 8 ตัวประจำ agent แต่ละบทบาท: เลขา, PM, Dev, QA, Writer, Content Director, Advisor และ Browser operator
หุ่นยนต์ประจำ agent แต่ละตัว วาดด้วยโค้ด SwiftUI ทั้งหมด ไม่ใช้ไฟล์ภาพหรือ library animation

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 หยุดอยู่" ทันที

ผลลัพธ์

ข้อจำกัด

สิ่งที่ได้เรียนรู้