v1.0.0 · open-source · zero-dependency node

TCLI — AI agent
ngay trong terminal của bạn

Giống opencode: AI lập kế hoạch → bạn duyệt → AI tự tạo file & chạy lệnh build trên máy. Điều hướng ←↑↓→ + Enter + Esc, 12+ theme, thinking hiển thị trực tiếp, log API minh bạch.

curl -fsSL https://tcli.pages.dev/install.sh | sh

Cài xong tự động thêm alias tcli và TCLI vào shell — mở terminal mới là chạy được (Node ≥ 18 được tự cài nếu thiếu).

~/du-an — tcli · BUILD ⚡

❯ gói app Node này, thêm Dockerfile, chạy test rồi commit
💭 thinking: đọc package.json → npm test → sửa lint…
⚙ run_command npm test → exit 0 · 130 tests
⚙ write_file Dockerfile · multi-stage node:20-alpine
✦ Đã xong: 4/4 bước — 130 test pass, build ok. Kiểm tra Dockerfile nhé.

Tính năng made for terminal folks

⚡

AI chạy thật trên máy

Tạo/sửa file, đọc dự án, grep, chạy lệnh shell (npm, git, docker…) trong thư mục dự án hoặc sandbox /tmp/tcli. Gate xác nhận bạn toàn quyền (/auto).

📋

Plan → Build

/plan: AI chỉ phân tích và đề xuất từng bước. Bạn duyệt, /build: AI tự thực thi toàn bộ kế hoạch, sửa lỗi khi test fail.

🧠

Thinking hiển thị

Nhận stream reasoning_content từ model — xem AI "suy nghĩ nghĩ" (vắng một lát trước khi ra code). Điều chỉnh độ sâu bằng /reason low|high|max.

🎨

12+ themes

Nord, Dracula, Tokyo Night, Cyberpunk, Matrix… đổi ngay bằng /theme hoặc tự trộn màu: /theme set accent=#00ffd5.

🛠

Log API minh bạch

Mọi request/status/latency/usage đều bị "bắt" và hiển thị ngay trong transcript + /logs để mở trace đầy đủ.

⌨

Điều hướng bàn phím

Mọi menu dùng ←↑↓→ di chuyển · Enter chọn · Esc quay lại — kể cả chọn model, theme, thư mục dự án.

Bảng lệnh

Lệnh	Tác dụng
/connect	Kết nối token — chọn xKiro (mặc định), OpenAI… hoặc base URL tuỳ ý
/model	Chọn model từ danh sách API của nhà cung cấp
/plan · /build · /chat	Đổi chế độ làm việc (plan chỉ đọc, build thực thi)
/project	Chọn thư mục dự án (trình duyệt thư mục ←↑↓→, cả tạo mới trong /tmp)
/theme	Giao diện — /theme set accent=#00ffd5 để custom
/reason	Mức thinking: none · low · medium · high · max
/auto	Bật/tắt hỏi trước khi chất tool (mặc định hỏi)
/logs	Xem rõ mọi log API + tool
/clear · /new · /exit	Xoá màn hình · phiên mới · thoát (Ctrl+C×2 cũng được)

Themes

Nord

Dracula

Tokyo Night

Cyberpunk Neon

Matrix

Gruvbox

…và Catppuccin, One Dark, Rosé Pine, Solarized, Light, Basic-16. Tự trộn màu: /theme set accent=#00ffd5 think=#7f8ea3

Kết nối nguồn AI — xKiro sk-xt-…

TCLI được cung cấp API bởi xKiro (chuẩn OpenAI-compatible, biên dịch tool gọi đa ngành qua 90+ model).

Lấy tokenVào xkiro.com/dashboard → API keys tạo token sk-xt-….

/connectChạy /connect → chọn xKiro → dán token. TCLI tự bấm nếu token chạy tốt + nạp model list.

/modelChọn model (VD openai/gpt-5.6-sol, z-ai/glm-5.3) — Enter là xong.

Bắt tay vào việc/project chọn folder, /plan lập kế hoạch, /build cho AI tự build. Khởi động!

# gọi nhanh không cần TUI (dán prompt cho API luôn trả code):
tcli "viết script python dò mật độ hợp lệ w3 validator cho 10 url"

# proxy WS tự set vì runtime mô phỏng: 
export TCLI_URL=https://mirror.yourdomain.dev   # nếu muốn tự host mirror install.sh

TCLI — AI agentngay trong terminal của bạn