v1.3.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 đủ.

⌨

Keyboard + Mouse

Menus: ←↑↓→ · Enter · Esc; click chuột chọn trực tiếp (SGR 1006). Transcript: PgUp/PgDn cuộn, wheel cuộn, tự về cuối khi ở lại theo dõi.

⌘

Bảng lệnh khi gõ `/`

Press / on empty input → palette hiện tất cả lệnh, gõ chữ để lọc, Enter chạy luôn — nhanh hơn bất kỳ GUI nào.

💾

Sessions lưu tự động

Hội thoại + usage + model được lưu vào ~/.tcli/sessions/; mở lại TCLI tự tiếp phiên — /session để chọn phiên cũ, Enter vào lại.

🔑

Token pool chống cháy quota

Thêm nhiều token (/tokens). Token chính hết quota (HTTP 402/429) → tự chuyển token phụ, chạy tiếp không dừng.

Bảng lệnh

Lệnh	Tác dụng
/connect · /tokens	Kết nối token (xKiro/OpenAI/tuỳ chỉnh). Pool nhiều token — chính + phụ chống cháy quota
/model (+badge)	Chọn model, ghi rõ FREE / PAID / PREMIUM + giá $/1M + tools/thinking/vision; gõ chữ lọc (vd "free")
/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
/session · /new	Chọn/vào lại phiên chat đã lưu · tạo phiên mới
/update	Tự quét phiên bản mới → tải + cài (mở lại TCLI để dùng)
/auto	Bật/tắt hỏi trước khi AI chạy tool (mặc định AUTO-RUN ON)
`/`	Mở bảng lệnh đầy đủ ngay trong input (type-to-filter)
/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 — token của bạn sk-xt-…

TCLI hoạt động với mọi API OpenAI-compatible. Dùng được ngay với xKiro (107 model, 49 FREE) — nhập token riêng của bạn, không cần thiết lập gì thêm.

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

/connectChạy /connect → chọn nhà cung cấp (VD xKiro) → dán token. Muốn phòng hờ: thêm token phụ bằng /tokens.

/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