kaokla — Kaokla Agent in your terminal

ผู้ช่วยวิศวกร AI + เอนจินคำนวณ deterministic 21 ตัว (ACI/AISC/มยผ./Eurocode) จาก kaoklahome.com — ทำงานในเทอร์มินัลของคุณ พร้อมอ่าน/เขียน/แก้ไฟล์และรันคำสั่งในเครื่อง (ขออนุญาตก่อนทุกครั้ง)

npm install -g kaokla
kaokla login     # เชื่อมบัญชีผ่านเบราว์เซอร์ (device flow — ไม่ต้องพิมพ์รหัสผ่านใน terminal)
cd my-project
kaokla           # เริ่ม cowork ในโฟลเดอร์นี้
kaokla -p "ตรวจคาน คสล. 0.20×0.40 ม. ช่วง 4 ม. รับ 25 kN/m fc' 24 fy 392"   # โหมดสคริปต์/pipe

ทำอะไรได้

• 💬 แชตวิศวกรรม — คำนวณคาน/เสา/ฐานราก/เหล็ก/ลม/ไฟฟ้า/ประปา/BOQ ด้วยเอนจิน deterministic (เหมือนบนเว็บ)
• 📂 ทำงานกับไฟล์ในเครื่อง — อ่าน/เขียน/แก้ไฟล์ · ค้นหา (glob/grep) · รันคำสั่ง shell — ทุกอย่างที่กระทบไฟล์/รันคำสั่ง ถามอนุญาตก่อน (y ใช่ · a ตลอด session · n ไม่)
• 🎨 UI เต็มรูป — markdown (ตาราง/โค้ด+highlight/สูตร) · แสดง diff ก่อนแก้ไฟล์ · การ์ดเครื่องมือ
• 🧭 บริบทโปรเจกต์ — อ่าน KAOKLA.md / AGENTS.md / CLAUDE.md ในโฟลเดอร์อัตโนมัติ
• 🔌 MCP — เสียบ MCP server ภายนอก (filesystem / GitHub / ฐานข้อมูล ฯลฯ) ผ่าน .kaokla/mcp.json (รูปแบบเดียวกับ Claude Desktop) — เครื่องมือทั้งหมดผ่าน permission gate เดียวกัน
• 🌿 Git worktree isolation — kaokla --worktree <ชื่อ> หรือ /worktree <ชื่อ> สร้าง branch kk/<ชื่อ> ใน checkout แยก; apply/delete มี preview และถาม y/N ทุกครั้ง
• 🔐 ปลอดภัย — ตรวจคำสั่งอันตราย · กันแตะไฟล์นอกโฟลเดอร์ · ตั้งกฎสิทธิ์ได้ที่ .kaokla/settings.json

เปิดเอนจินให้ AI ตัวอื่นเรียก (MCP server)

ให้ Claude Desktop / Cursor / AI host อื่นเรียก เอนจินคำนวณ 21 ตัว ของ Kaokla ผ่าน MCP (ต้องมีคีย์ kk_live_ จาก /developers — แผน Engineer/Team). เพิ่มใน config ของ host:

{ "mcpServers": {
  "kaokla": { "command": "kaokla", "args": ["mcp-server"], "env": { "KAOKLA_API_KEY": "kk_live_…" } }
} }

การตั้งค่า

• ต้องมีบัญชี Kaokla (สมัคร/ทดลองฟรีที่ kaoklahome.com) — โควตา AI เดียวกับเว็บ
• Node.js ≥ 22.17 · macOS / Linux / Windows
• token เก็บที่ ~/.config/kaokla/credentials.json (mode 600) · เพิกถอนได้ที่ /developers
• kaokla --classic = UI แบบเรียบ (readline) · แนะนำ terminal ที่ render ไทยดี เช่น iTerm2 / Ghostty
• .kaokla/settings.json รองรับ "autoWorktree": true เพื่อ เสนอ สร้าง worktree ตอนเปิดจาก main (default false; ยังถามและข้ามได้เสมอ)

worktree มี cwd ของตัวเอง ดังนั้น Kaokla จะถาม trust ของ .kaokla/settings.json ใหม่ใน checkout นั้นตามตั้งใจ และ /worktree จะไม่สลับ cwd กลาง session—ให้เปิด terminal/session ใหม่ที่ path ซึ่งแสดงผล

คำสั่ง

kaokla เริ่ม cowork · kaokla "คำถาม" ถามครั้งเดียว · kaokla -p โหมด pipe · kaokla --worktree <ชื่อ> เริ่มใน checkout แยก · kaokla login / logout / whoami / doctor

ในแชต: /worktrees ดูรายการ · /worktree <ชื่อ> สร้าง checkout แยก · /branch <ชื่อ> สร้าง/checkout branch · /apply-worktree <ชื่อ> แสดง commit แล้ว merge กลับ main · /delete-worktree <ชื่อ> ลบ checkout แบบไม่ force (ห้ามลบ worktree ที่ session ปัจจุบันกำลังใช้อยู่)

⚠️ ผลคำนวณเป็นเครื่องมือช่วยเบื้องต้น — ต้องตรวจสอบและรับรองโดยวิศวกรผู้มีใบอนุญาตก่อนใช้จริงทุกกรณี

MIT © 2026 Kaoklahome