CLI

CodeTutor CLI จะเริ่มต้น TUI เป็นค่าเริ่มต้นเมื่อเรียกใช้โดยไม่มีอาร์กิวเมนต์

opencode

นอกจากนี้ยังรับคำสั่งและแฟล็ก ซึ่งช่วยให้คุณใช้ CodeTutor ผ่านโปรแกรมได้

codetutor run "Explain how closures work in JavaScript"

---

tui

เริ่ม TUI เพื่อใช้ CodeTutor แบบโต้ตอบ

opencode [project]

แฟล็ก

แฟล็ก	สั้น	คำอธิบาย
--continue	-c	ดำเนินการต่อจากเซสชันล่าสุด
--session	-s	ID เซสชันเพื่อดำเนินการต่อ
--fork		แยกเซสชันเมื่อทำต่อ (ใช้กับ --continue หรือ --session)
--prompt		พรอมต์เริ่มต้นที่จะใช้
--model	-m	โมเดลที่จะใช้ในรูปแบบ provider/model
--agent		เอเจนต์ที่จะใช้
--port		พอร์ตที่จะฟัง
--hostname		ชื่อโฮสต์ที่จะฟัง

---

คำสั่ง

CodeTutor CLI ยังมีคำสั่งย่อยอีกมากมาย

---

agent

จัดการเอเจนต์สำหรับ CodeTutor

codetutor agent [command]

---

attach

เชื่อมต่อกับเซิร์ฟเวอร์แบ็กเอนด์ CodeTutor ที่กำลังทำงานอยู่ ซึ่งเริ่มต้นผ่านคำสั่ง serve หรือ web

codetutor attach [url]

วิธีนี้ช่วยให้คุณใช้ TUI กับแบ็กเอนด์ CodeTutor ระยะไกลได้ ตัวอย่าง:

# Start the backend server for web/mobile access
codetutor web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
codetutor attach http://10.20.30.40:4096

แฟล็ก

แฟล็ก	สั้น	คำอธิบาย
--dir		ไดเร็กทอรีการทำงานเพื่อเริ่มต้น TUI ใน
--continue	-c	ดำเนินการต่อจากเซสชันล่าสุด
--session	-s	ID เซสชันเพื่อดำเนินการต่อ
--fork		แยกเซสชันเมื่อดำเนินการต่อ (ใช้กับ --continue หรือ --session)
--password	-p	รหัสผ่านการยืนยันตัวตนพื้นฐาน (ค่าเริ่มต้นคือ CODETUTOR_SERVER_PASSWORD)
--username	-u	ชื่อผู้ใช้การยืนยันตัวตนพื้นฐาน (ค่าเริ่มต้นคือ CODETUTOR_SERVER_USERNAME หรือ codetutor)

---

create

สร้างเอเจนต์ใหม่

codetutor agent create

คำสั่งนี้จะแนะนำคุณตลอดกระบวนการสร้างเอเจนต์ใหม่ พร้อมพรอมต์ระบบและความสามารถของเครื่องมือ

---

list

แสดงรายชื่อเอเจนต์ที่พร้อมใช้งานทั้งหมด

codetutor agent list

---

auth

จัดการการตรวจสอบสิทธิ์และข้อมูลรับรอง

codetutor auth [command]

---

login

CodeTutor ได้รับการกำหนดค่าไว้ล่วงหน้าด้วยรายชื่อผู้ให้บริการทั่วไปที่ Models.dev ดังนั้นคุณเพียงแค่ต้องใส่คีย์ API สำหรับผู้ให้บริการที่คุณต้องการใช้ ข้อมูลนี้จะถูกเก็บไว้ที่ ~/.local/share/opencode/auth.json

codetutor auth login

เมื่อ CodeTutor เริ่มต้น ระบบจะโหลดข้อมูลรับรองจากไฟล์นี้ ดังนั้นคุณจึงไม่ต้องกังวลกับการตั้งค่าตัวแปรสภาพแวดล้อมหรือไฟล์ .env ในโปรเจ็กต์ของคุณ

---

list

แสดงรายการข้อมูลรับรองการตรวจสอบสิทธิ์ทั้งหมดที่กำหนดค่าไว้

codetutor auth list

หรือใช้นามแฝงสั้น

codetutor auth ls

---

logout

ออกจากระบบของผู้ให้บริการและลบข้อมูลรับรองออกจากไฟล์ auth

codetutor auth logout

---

github

จัดการเอเจนต์ GitHub สำหรับเวิร์กโฟลว์อัตโนมัติ

codetutor github [command]

---

install

ติดตั้งเอเจนต์ GitHub ใน repository ของคุณ

codetutor github install

คำสั่งนี้จะสร้างเวิร์กโฟลว์ GitHub Actions และแนะนำคุณตลอดกระบวนการตั้งค่า เรียนรู้เพิ่มเติม

---

run

รันเอเจนต์ GitHub ด้วยตนเองหรือใน GitHub Actions

codetutor github run

แฟล็ก

แฟล็ก	คำอธิบาย
--event	เหตุการณ์ GitHub เพื่อทริกเกอร์เอเจนต์
--token	GitHub token

---

mcp

จัดการเซิร์ฟเวอร์ Model Context Protocol (MCP)

codetutor mcp [command]

---

add

เพิ่มเซิร์ฟเวอร์ MCP ลงในการกำหนดค่าของคุณ

codetutor mcp add

คำสั่งนี้จะแนะนำคุณผ่านวิซาร์ดเพื่อกำหนดค่าเซิร์ฟเวอร์ MCP ใหม่

---

list

แสดงรายชื่อเซิร์ฟเวอร์ MCP ทั้งหมดที่กำหนดค่าไว้และสถานะ

codetutor mcp list

หรือใช้นามแฝงสั้น

codetutor mcp ls

---

auth

ยืนยันตัวตนกับเซิร์ฟเวอร์ MCP ที่ต้องการ OAuth

codetutor mcp auth [name]

หากไม่ระบุชื่อเซิร์ฟเวอร์ คุณจะได้รับแจ้งให้เลือกจากเซิร์ฟเวอร์ที่รองรับ OAuth ที่พร้อมใช้งาน

คุณยังสามารถแสดงรายการสถานะการตรวจสอบสิทธิ์ OAuth ได้:

codetutor mcp auth list

หรือใช้นามแฝงสั้น

codetutor mcp auth ls

---

logout

ลบข้อมูลรับรอง OAuth สำหรับเซิร์ฟเวอร์ MCP

codetutor mcp logout [name]

---

debug

ดีบักการเชื่อมต่อเซิร์ฟเวอร์ MCP

codetutor mcp debug <name>

---

models

แสดงรายการโมเดลที่พร้อมใช้งานทั้งหมดจากผู้ให้บริการที่กำหนดค่าไว้

codetutor models [provider]

คำสั่งนี้จะแสดง ID โมเดลทั้งหมดในรูปแบบ provider/model

คุณสามารถใช้ชื่อโมเดลเหล่านี้ในการกำหนดค่า config ของคุณ

คุณยังสามารถส่งผ่านรหัสผู้ให้บริการเพื่อกรองโมเดลตามผู้ให้บริการรายนั้นได้

codetutor models anthropic

แฟล็ก

แฟล็ก	คำอธิบาย
--refresh	รีเฟรชแคชโมเดลจาก models.dev
--verbose	แสดงรายละเอียดโมเดลเพิ่มเติม (รวมข้อมูลเมตาเช่นต้นทุน)
--json	แสดงผลลัพธ์เป็น JSON

ใช้แฟล็ก --refresh เพื่ออัปเดตรายการโมเดลที่แคชไว้ มีประโยชน์เมื่อมีการเพิ่มโมเดลใหม่ให้กับผู้ให้บริการและคุณต้องการเห็นใน CodeTutor

codetutor models --refresh

---

run

รัน CodeTutor โดยไม่ต้องใช้ TUI โดยส่งพรอมต์โดยตรง

codetutor run [message..]

มีประโยชน์สำหรับการทำงานอัตโนมัติหรือเมื่อต้องการคำตอบอย่างรวดเร็วโดยไม่ต้องเปิด TUI ตัวอย่าง:

codetutor run Explain the use of context in Go

คุณยังสามารถแนบไปกับเซิร์ฟเวอร์ codetutor serve ที่ทำงานอยู่ หรือใช้เซิร์ฟเวอร์ MCP แบบ headless:

# Start a headless server in one terminal
codetutor serve

# In another terminal, run commands that attach to it
codetutor run --attach http://localhost:4096 "Explain async/await in JavaScript"

แฟล็ก

แฟล็ก	สั้น	คำอธิบาย
--command		คำสั่งที่จะรัน (ใช้ส่วนที่เหลือของ args เป็นอาร์กิวเมนต์)
--continue	-c	ดำเนินการต่อจากเซสชันล่าสุด
--session	-s	ID เซสชันเพื่อดำเนินการต่อ
--fork		แยกเซสชันเมื่อทำต่อ (ใช้กับ --continue หรือ --session)
--share		สร้างลิงก์แชร์สำหรับเซสชัน
--model	-m	โมเดลที่จะใช้ในรูปแบบ provider/model
--agent		เอเจนต์ที่จะใช้
--file	-f	แนบไฟล์ไปกับข้อความ
--format		รูปแบบเอาต์พุต: text (จัดรูปแบบ) หรือ json (JSON ดิบ)
--title		ชื่อสำหรับเซสชัน (หากไม่ได้ระบุ จะสร้างจากพรอมต์)
--attach		แนบไปกับเซิร์ฟเวอร์ opencode ที่ทำงานอยู่ (เช่น http://localhost:4096)
--password	-p	รหัสผ่านการยืนยันตัวตนพื้นฐาน (ค่าเริ่มต้นคือ CODETUTOR_SERVER_PASSWORD)
--username	-u	ชื่อผู้ใช้การยืนยันตัวตนพื้นฐาน (ค่าเริ่มต้นคือ CODETUTOR_SERVER_USERNAME หรือ codetutor)
--dir		ไดเร็กทอรีสำหรับรัน หรือเส้นทางบนเซิร์ฟเวอร์ระยะไกลเมื่อแนบ
--variant		ตัวแปรโมเดล (ระดับการใช้เหตุผลเฉพาะผู้ให้บริการ)
--thinking		แสดงบล็อกความคิด
--port		พอร์ตสำหรับเซิร์ฟเวอร์ภายในเครื่อง (หากไม่ได้ระบุ จะใช้พอร์ตสุ่ม)

---

serve

เริ่มต้นเซิร์ฟเวอร์ CodeTutor headless ที่ให้บริการ API HTTP ดู เอกสารเซิร์ฟเวอร์ สำหรับรายละเอียด API เต็มรูปแบบ

codetutor serve

คำสั่งนี้จะเริ่มต้นเซิร์ฟเวอร์ HTTP ให้ API เข้าถึงฟังก์ชันการทำงานของ CodeTutor ได้โดยไม่ต้องมี TUI นอกจากนี้ยังรองรับการตรวจสอบสิทธิ์พื้นฐาน HTTP (ชื่อผู้ใช้เริ่มต้นคือ codetutor และรหัสผ่านระบุโดย CODETUTOR_SERVER_PASSWORD)

แฟล็ก

แฟล็ก	คำอธิบาย
--port	พอร์ตที่จะฟัง
--hostname	ชื่อโฮสต์ที่จะฟัง
--mdns	เปิดใช้งานการค้นหา mDNS
--cors	ต้นกำเนิดเพิ่มเติมที่อนุญาตสำหรับ CORS

---

session

จัดการเซสชัน CodeTutor

codetutor session [command]

---

list

แสดงรายการเซสชัน CodeTutor ทั้งหมด

codetutor session list

แฟล็ก

แฟล็ก	สั้น	คำอธิบาย
--max-count	-n	จำกัดการแสดงผล N รายการล่าสุด
--format		รูปแบบ table หรือ json

---

stats

แสดงสถิติการใช้งานและค่าใช้จ่ายสำหรับ CodeTutor ของคุณ

codetutor stats

แฟล็ก

แฟล็ก	คำอธิบาย
--days	แสดงสถิติของ N วันที่ผ่านมา (ค่าเริ่มต้น: ตลอดเวลา)
--tools	แสดงสถิติการใช้เครื่องมือ
--models	แสดงรายละเอียดการใช้งานโมเดล (ซ่อนไว้ตามค่าเริ่มต้น)
--project	กรองตามโครงการ (ค่าเริ่มต้น: โครงการปัจจุบัน)

---

export

ส่งออกประวัติเซสชันเป็น JSON

codetutor export [sessionID]

หากไม่ระบุรหัสเซสชัน คุณจะได้รับแจ้งให้เลือกจากรายการล่าสุด

---

import

นำเข้าเซสชันจากไฟล์ JSON หรือ URL ที่แชร์ของ CodeTutor

codetutor import <file>

คุณสามารถนำเข้าไฟล์ในเครื่องหรือ URL ที่แชร์

codetutor import session.json
codetutor import https://opncd.ai/s/abc123

---

web

เริ่ม CodeTutor ในโหมดเซิร์ฟเวอร์พร้อมเว็บอินเตอร์เฟส

codetutor web

คำสั่งนี้จะเริ่มต้นเซิร์ฟเวอร์ HTTP และเปิดเว็บเบราว์เซอร์เพื่อเข้าถึง CodeTutor ผ่านทางเว็บอินเตอร์เฟส รองรับการตรวจสอบสิทธิ์พื้นฐาน HTTP (ชื่อผู้ใช้เริ่มต้นคือ codetutor และรหัสผ่านระบุโดย CODETUTOR_SERVER_PASSWORD)

แฟล็ก

แฟล็ก	คำอธิบาย
--port	พอร์ตที่จะฟัง
--hostname	ชื่อโฮสต์ที่จะฟัง
--mdns	เปิดใช้งานการค้นหา mDNS
--cors	ต้นกำเนิดเพิ่มเติมที่อนุญาตสำหรับ CORS

---

acp

เริ่มต้นเซิร์ฟเวอร์ ACP (Agent Client Protocol)

codetutor acp

คำสั่งนี้เริ่มต้นเซิร์ฟเวอร์ ACP ที่สื่อสารผ่าน stdin/stdout ด้วย nd-JSON

แฟล็ก

แฟล็ก	คำอธิบาย
--cwd	ไดเร็กทอรีการทำงาน
--port	พอร์ตที่จะฟัง
--hostname	ชื่อโฮสต์ที่จะฟัง

---

uninstall

ถอนการติดตั้ง CodeTutor และลบข้อมูลการกำหนดค่าทั้งหมด

codetutor uninstall

แฟล็ก

แฟล็ก	สั้น	คำอธิบาย
--keep-config	-c	เก็บไฟล์การกำหนดค่าไว้
--keep-data	-d	เก็บไฟล์ข้อมูล (เซสชันและสแน็ปช็อต)
--dry-run		แสดงสิ่งที่จะลบออกโดยไม่ต้องทำจริง
--force	-f	บังคับลบโดยไม่มีการแจ้งเตือน

---

upgrade

อัปเกรด CodeTutor เป็นเวอร์ชันล่าสุดหรือเวอร์ชันที่ระบุ

codetutor upgrade [target]

อัปเกรดเป็นเวอร์ชันล่าสุด

codetutor upgrade

อัปเกรดเป็นเวอร์ชันที่ระบุ

codetutor upgrade v0.1.48

แฟล็ก

แฟล็ก	สั้น	คำอธิบาย
--method	-m	วิธีการติดตั้งที่ใช้ curl, npm, pnpm, bun, brew

---

แฟล็กระดับโลก

CodeTutor CLI ยอมรับแฟล็กสากลต่อไปนี้สำหรับทุกคำสั่ง

แฟล็ก	สั้น	คำอธิบาย
--help	-h	แสดงความช่วยเหลือ
--version	-v	พิมพ์เวอร์ชัน
--print-logs		พิมพ์บันทึกไปยัง stderr
--log-level		ระดับการบันทึก (DEBUG, INFO, WARN, ERROR)

---

ตัวแปรสภาพแวดล้อม

CodeTutor สามารถกำหนดค่าโดยใช้ตัวแปรสภาพแวดล้อม

ตัวแปร	ชนิด	คำอธิบาย
CODETUTOR_AUTO_SHARE	Boolean	แชร์เซสชันอัตโนมัติเมื่อสร้าง
CODETUTOR_GIT_BASH_PATH	String	เส้นทางไปยัง Git Bash บน Windows
CODETUTOR_CONFIG	String	เส้นทางไปยังไฟล์การกำหนดค่า
CODETUTOR_TUI_CONFIG	String	เส้นทางไปยังไฟล์การกำหนดค่า TUI
CODETUTOR_CONFIG_DIR	String	เส้นทางไปยังไดเร็กทอรีการกำหนดค่า
CODETUTOR_CONFIG_CONTENT	String	เนื้อหาการกำหนดค่าแบบ inline JSON
CODETUTOR_DISABLE_AUTOUPDATE	Boolean	ปิดใช้งานการอัปเดตอัตโนมัติ
CODETUTOR_DISABLE_PRUNE	Boolean	ปิดใช้งานการลบข้อมูลเซสชันเก่า
CODETUTOR_DISABLE_TERMINAL_TITLE	Boolean	ปิดใช้งานการตั้งชื่อหน้าต่าง terminal
CODETUTOR_PERMISSION	String	การกำหนดค่าสิทธิ์แบบ inline JSON
CODETUTOR_DISABLE_DEFAULT_PLUGINS	Boolean	ปิดใช้งานปลั๊กอินเริ่มต้น
CODETUTOR_DISABLE_LSP_DOWNLOAD	Boolean	ปิดใช้งานการดาวน์โหลด LSP อัตโนมัติ
CODETUTOR_ENABLE_EXPERIMENTAL_MODELS	Boolean	เปิดใช้งานโมเดลทดลอง
CODETUTOR_DISABLE_AUTOCOMPACT	Boolean	ปิดใช้งานการบีบอัดบริบทอัตโนมัติ
CODETUTOR_DISABLE_CLAUDE_CODE	Boolean	ปิดใช้งานการนำเข้าจาก .claude (prompt + skills)
CODETUTOR_DISABLE_CLAUDE_CODE_PROMPT	Boolean	ปิดใช้งานการนำเข้า ~/.claude/CLAUDE.md
CODETUTOR_DISABLE_CLAUDE_CODE_SKILLS	Boolean	ปิดใช้งานการนำเข้า .claude/skills
CODETUTOR_DISABLE_MODELS_FETCH	Boolean	ปิดใช้งานการดึงรายการโมเดลจากระยะไกล
CODETUTOR_FAKE_VCS	String	เปิดใช้งาน VCS จำลองสำหรับการทดสอบ
CODETUTOR_CLIENT	String	ตัวระบุไคลเอนต์ (ค่าเริ่มต้นคือ cli)
CODETUTOR_ENABLE_EXA	Boolean	เปิดใช้งานการใช้ Exa แทน ls หากมี
CODETUTOR_SERVER_PASSWORD	String	รหัสผ่านสำหรับการตรวจสอบสิทธิ์พื้นฐาน serve/web
CODETUTOR_SERVER_USERNAME	String	ชื่อผู้ใช้สำหรับการตรวจสอบสิทธิ์พื้นฐาน (ค่าเริ่มต้น codetutor)
CODETUTOR_MODELS_URL	String	URL ที่กำหนดเองสำหรับการดึงรายการโมเดล

---

ขั้นทดลอง

ตัวแปรสภาพแวดล้อมเหล่านี้เปิดใช้งานฟีเจอร์ทดลองที่อาจมีการเปลี่ยนแปลงหรือถูกลบออก

ตัวแปร	ชนิด	คำอธิบาย
CODETUTOR_EXPERIMENTAL	Boolean	เปิดใช้งานฟีเจอร์ทดลองภายใต้แฟล็กรวม
CODETUTOR_EXPERIMENTAL_ICON_DISCOVERY	Boolean	การค้นหาไอคอนทดลอง
CODETUTOR_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	Boolean	ปิดใช้งานการคัดลอกเมื่อเลือกใน TUI
CODETUTOR_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	Number	การหมดเวลาเริ่มต้นสำหรับคำสั่ง bash ในหน่วย ms
CODETUTOR_EXPERIMENTAL_OUTPUT_TOKEN_MAX	Number	ขีดจำกัดสูงสุดสำหรับโทเค็นเอาต์พุต LLM
CODETUTOR_EXPERIMENTAL_FILEWATCHER	Boolean	เปิดใช้งานตัวเฝ้าดูไฟล์สำหรับไดเร็กทอรีทั้งหมด
CODETUTOR_EXPERIMENTAL_OXFMT	Boolean	ใช้ oxfmt เป็นตัวจัดรูปแบบ
CODETUTOR_EXPERIMENTAL_LSP_TOOL	Boolean	เปิดใช้งานเครื่องมือ LSP ทดลอง
CODETUTOR_EXPERIMENTAL_DISABLE_FILEWATCHER	Boolean	ปิดใช้งานตัวเฝ้าดูไฟล์
CODETUTOR_EXPERIMENTAL_EXA	Boolean	ฟีเจอร์ Exa ทดลอง
CODETUTOR_EXPERIMENTAL_LSP_TY	Boolean	เปิดใช้งาน TY LSP สำหรับไฟล์ python
CODETUTOR_EXPERIMENTAL_PLAN_MODE	Boolean	เปิดใช้งาน Plan mode
CODETUTOR_EXPERIMENTAL_BACKGROUND_SUBAGENTS	Boolean	เปิดใช้งานงาน subagent เบื้องหลัง
CODETUTOR_EXPERIMENTAL_EVENT_SYSTEM	Boolean	เปิดใช้งานระบบเหตุการณ์ทดลอง
CODETUTOR_EXPERIMENTAL_NATIVE_LLM	Boolean	เปิดใช้งานเส้นทางคำขอ LLM แบบ native
CODETUTOR_EXPERIMENTAL_PARALLEL	Boolean	เปิดใช้งานการค้นหาเว็บแบบขนาน
CODETUTOR_EXPERIMENTAL_SCOUT	Boolean	เปิดใช้งาน Scout subagent
CODETUTOR_EXPERIMENTAL_WORKSPACES	Boolean	เปิดใช้งานการรองรับ workspace