Kawe Agent CLI

ติดตั้งInstallation

Windows

วิธีที่ 1: PowerShell (แนะนำ)Method 1: PowerShell (recommended)

irm https://get.kaweai.com/install.ps1 | iex

วิธีที่ 2: ผ่าน WSL (ใช้ bash tool ได้เต็ม)Method 2: WSL (full bash support)

wsl --install

จากนั้นเปิด WSL (Ubuntu):Then open WSL (Ubuntu):

curl -fsSL https://get.kaweai.com/install.sh | sh

macOS

curl -fsSL https://get.kaweai.com/install.sh | sh

Linux

curl -fsSL https://get.kaweai.com/install.sh | sh

ตรวจสอบว่าติดตั้งสำเร็จ:Verify installation:

kawe --version

เริ่มต้นใช้งานGetting Started

1. Login

kawe auth login

• Browser จะเปิดอัตโนมัติ → login ด้วยบัญชีของคุณBrowser opens automatically → login with your account
• ถ้า browser ไม่เปิด (เช่น SSH): copy URL จาก terminal ไปเปิดเองIf browser doesn't open (e.g. SSH): copy URL from terminal
• รอจน terminal แสดง "Login successful"Wait for "Login successful" in terminal

2. เริ่ม Chat2. Start Chat

cd your-project
kawe chat

เข้า directory ของโปรเจคก่อน → Kawe จะรู้จัก project ของคุณอัตโนมัติ (อ่าน package.json, go.mod, etc.)Enter your project directory first → Kawe auto-detects your project (reads package.json, go.mod, etc.)

3. สั่งงาน3. Give Commands

4. Slash Commands ที่ใช้บ่อย4. Common Slash Commands

วิธีใช้งานUsage Modes

แบบสนทนา (Interactive)Interactive

kawe chat

พิมพ์ข้อความ → AI ตอบ → พิมพ์ต่อ → วนไปจนกว่าจะพิมพ์ /quit หรือ Ctrl+CType → AI responds → continue until /quit or Ctrl+C

แบบสั่งครั้งเดียว (One-shot)One-shot

kawe chat -p "แก้ typo ใน README.md" --auto-approve

สั่งงานทีเดียว ไม่ต้องโต้ตอบ — เหมาะสำหรับ CI/CD หรือ automationRun once, no interaction — great for CI/CD

kawe chat -p "สวัสดี" --json

ผลลัพธ์เป็น JSON — เหมาะกับ scriptingJSON output — great for scripting

CLI Flags

Pipe

cat error.log | kawe chat -p "อธิบาย error นี้"

เปลี่ยน RoleChange Role

ใช้คำสั่ง /agent ระหว่าง chat:Use /agent command during chat:

/agent qa         → ให้ AI เป็น QA — หา bugs, เขียน tests
/agent architect  → ให้ AI เป็น Architect — ออกแบบระบบ
/agent writer     → ให้ AI เป็น Technical Writer — เขียน docs
/agent dev        → ให้ AI เป็น Developer — เขียนโค้ด

ตัวอย่างการใช้งานUsage Examples

Auto-approve

ให้ AI ทำงานโดยไม่ต้องถาม confirm ทุกขั้นตอน:Let AI work without asking for confirmation:

# ผ่าน flag
kawe chat -p "run tests and fix failures" --auto-approve

# หรือพิมพ์ระหว่าง chat
/trust-all

File Lock — ป้องกันไฟล์สำคัญFile Lock — Protect Important Files

กำหนดไฟล์ที่ AI จะไม่แตะ ใน .kawerc:Define files AI won't touch in .kawerc:

{
  "lockedFiles": ["config.prod.yml", ".env*", "*.key", "docker-compose.prod.yml"]
}

AI จะปฏิเสธการแก้ไขไฟล์ที่ตรง pattern เหล่านี้AI will refuse to edit files matching these patterns

Session & Undo

• Auto-save — ทุก turn บันทึกอัตโนมัติEvery turn saved automatically
• Resume — ใช้ kawe chat --resume เพื่อต่อจาก session ล่าสุดของ project นั้นUse kawe chat --resume to continue last session for that project
• Undo — /undo ย้อนไฟล์กลับก่อนที่ AI แก้revert file to before AI edit
• Rewind — /rewind ย้อนกลับทั้ง session ไปจุดก่อนหน้าrewind entire session to earlier point

Keyboard Shortcuts

ตั้งค่าConfiguration

Kawe ใช้ 2 อย่างที่ชื่อคล้ายกัน:Kawe uses 2 similar-named things:

• .kawerc — ตั้งค่า ตัวโปรแกรม (timeout, theme, sandbox, ไฟล์ที่ห้ามแก้)Configure the program (timeout, theme, sandbox, locked files)
• .kawe/ — ตั้งค่า ตัว AI (กฎ, บทบาท, คำสั่งพิเศษ, skills)Configure the AI (rules, roles, commands, skills)

.kawerc — ตั้งค่าตัวโปรแกรมProgram Settings

ไฟล์ JSON ที่บอกโปรแกรม Kawe ว่าทำงานยังไง (AI ไม่ได้อ่านไฟล์นี้)JSON file that tells the Kawe program how to behave (AI doesn't read this)

ชื่อไฟล์: เลือกอย่างใดอย่างหนึ่ง (เนื้อหาเหมือนกัน):File name: pick either (same content):

• .kawerc — ไม่มีนามสกุล (เหมือน .eslintrc)no extension (like .eslintrc)
• .kawerc.json — มีนามสกุล (editor จะ highlight syntax ให้)with extension (editor syntax highlighting)

ลำดับการอ่าน: default → ~/.kawerc → <project>/.kawerc (ค่าหลังทับค่าก่อน)Load order: default → ~/.kawerc → <project>/.kawerc (later overrides earlier)

ตัวอย่าง Global (~/.kawerc):Global example (~/.kawerc):

{
  "theme": "dark",
  "timeout": 180000
}

ตัวอย่าง Project (my-project/.kawerc):Project example:

{
  "sandbox": { "enabled": true },
  "lockedFiles": ["*.env", "config.prod.*", "docker-compose.prod.yml"]
}

💡 Project config จะ override global (ยกเว้น API URL ที่ project เปลี่ยนไม่ได้)💡 Project overrides global (except API URL)

.kawe/ — ตั้งค่าตัว AIAI Settings

โฟลเดอร์ที่บอก AI ว่าควรทำตัวยังไง (โปรแกรมอ่านแล้ว inject เข้าไปให้ AI)Folder that tells AI how to behave (program reads and injects for AI)

my-project/.kawe/
├── steering/    ← กฎที่ AI ต้องปฏิบัติตามเสมอRules AI must always follow
├── commands/    ← คำสั่ง slash ที่คุณสร้างเองCustom slash commands
├── roles/       ← บทบาท AI ที่คุณสร้างเองCustom AI roles
├── skills/      ← skills ที่ติดตั้งInstalled skills
└── hooks.json   ← script ที่รันก่อน/หลัง AI ใช้ toolScripts run before/after tool use

Steering — กฎสำหรับ AIRules for AI

# .kawe/steering/rules.md
- ตอบภาษาไทยเสมอ
- ใช้ Go idioms ห้ามใช้ panic
- เขียน test ทุกครั้งที่สร้าง function ใหม่

Custom Commands

# .kawe/commands/deploy.md
Deploy โปรเจคนี้:
1. รัน tests ก่อน
2. Build production
3. Push ไป registry

ใช้งาน: พิมพ์ /deploy ระหว่าง chatUsage: type /deploy during chat

Skills

# ติดตั้ง skill จาก GitHub
/skill add github.com/user/my-skill --skill my-skill

# เปิดใช้ / ดูรายการ / ลบ
/skill enable <name>
/skill                 # list skills ที่ติดตั้ง
/skill remove <name>

# หรือวางเอง
mkdir -p .kawe/skills
echo "..." > .kawe/skills/my-skill.md

AI จะใช้ skill อัตโนมัติเมื่อบริบทตรงกันAI uses skills automatically when context matches

# .kawe/roles/devops.md
## Role: DevOps Engineer
คุณคือ DevOps engineer เชี่ยวชาญ Docker, Kubernetes, CI/CD

ใช้งาน: /agent devopsUsage: /agent devops

Hooks

// .kawe/hooks.json
[{"event": "PostToolUse", "matcher": "fs_write", "command": "npm run lint --fix"}]

ทุกครั้งที่ AI แก้ไขไฟล์ (fs_write) → lint จะรันอัตโนมัติEvery time AI edits a file (fs_write) → lint runs automatically

• matcher — ชื่อ tool ที่จะ trigger (คั่นด้วย comma ได้ เช่น "fs_write,bash" หรือ "*" = ทุก tool)Tool name to trigger (comma-separated, or "*" for all)
• Event ที่ใช้บ่อยที่สุด: PreToolUse, PostToolUseMost common events: PreToolUse, PostToolUse

อัพเดทUpdate

kawe update

Reference: Tools (20 tools)

AI ใช้ tools เหล่านี้ทำงานให้อัตโนมัติAI uses these tools automatically

Reference: Slash Commands (39+ คำสั่ง)

รายการนี้ไม่รวม skill/custom commands ที่ติดตั้งเพิ่มได้ — พิมพ์ /help เพื่อดูรายการที่ active อยู่จริงExcludes installed skill/custom commands — type /help to see what's actually active

Reference: Agent Roles (11 roles)

สร้าง custom role: วาง .md ใน .kawe/roles/Custom roles: place .md in .kawe/roles/

Reference: Meeting Mode (4 templates × 2 โหมด)

2 โหมดการใช้งาน2 Usage Modes

⚠️ --deep จะถามยืนยันก่อนรัน ("will make ~5 API calls") เพราะใช้เครดิตมากกว่าปกติ⚠️ --deep prompts for confirmation ("will make ~5 API calls") as it costs significantly more

Deep Mode — 3 Perspectives ตามหัวข้อDeep Mode — 3 Perspectives per Template

Templates (4 หัวข้อtypes)

ตัวอย่างExamples

# โหมดปกติ (1 API call)
/meeting design ระบบ auth ใหม่
/meeting brainstorm ไอเดีย team building Q4

# Deep mode (5 API calls — ถามยืนยันก่อนรัน)
/meeting --deep review internal/auth/login.go
/meeting --deep sprint สรุปงาน sprint 14

# ไม่ใส่ template → เปิดเมนูเลือก
/meeting

# ไม่ใส่ topic → ใช้ "general discussion"
/meeting design

📄 ผลลัพธ์ทุกครั้งถูกบันทึกอัตโนมัติที่ .kawe/docs/meeting-<template>[-deep]-<timestamp>.md — เปิดอ่านย้อนหลังได้เสมอ📄 Every result is auto-saved to .kawe/docs/meeting-<template>[-deep]-<timestamp>.md — always accessible later