AIDEV

AI coding agent chạy trong terminal (giống Claude Code / OpenCode), viết bằng TypeScript, không phụ thuộc thư viện ngoài (zero runtime dependency), hỗ trợ đa provider theo chuẩn OpenAI hoặc Anthropic.

Cài đặt

npm install -g @hdquan/aidev

Sau khi cài, dùng lệnh aidev.

Chạy lần đầu

Chạy aidev khi chưa có cấu hình sẽ tự mở trình cài đặt (wizard):

1. Chọn provider bằng phím mũi tên ↑/↓ (danh sách xếp A→Z, mục Custom luôn ở cuối). Gõ chữ bất kỳ để lọc/tìm nhanh theo tên provider đã chọn.
2. Xác nhận hoặc nhập base URL.
3. Nhập API key và tên model.
4. Chọn có tự động đồng ý mọi lệnh (yes_always) và có bật auto-update hay không.

Cấu hình được lưu tại ~/.aidev/config/config.toml.

Muốn cấu hình lại bất cứ lúc nào:

aidev config
# hoặc
aidev settings

(Không còn dùng các cờ --model/--apikey/--linkbase nữa — mọi cấu hình đi qua aidev config.)

Chế độ (mode)

Nhấn Tab trong REPL để đổi mode theo vòng: plan → agent → tc-agent → plan → ...

| Mode | Ý nghĩa | |---|---| | plan | Chỉ đọc file / liệt kê thư mục, AI phải đưa ra kế hoạch trước, không được sửa file hay chạy lệnh | | agent | Agent đầy đủ, AI gọi tool bằng cú pháp XML đặc biệt tự quét trong câu trả lời (dùng cho model không có tool-calling gốc) | | tc-agent | Agent đầy đủ, dùng đúng cơ chế tool-calling gốc (function calling) của model/provider |

Toolcall XML đặc biệt (mode agent)

<aidev_call name="bash">
<aidev_param name="command">ls -la</aidev_param>
</aidev_call>

Tên thẻ aidev_call/aidev_param được cố tình chọn dài & có tiền tố riêng để không lẫn với code thường. Ngoài ra, trước khi quét, toàn bộ các khối ```code``` trong câu trả lời đều được "che" đi, nên ví dụ code do AI viết ra không bao giờ bị hiểu nhầm thành lệnh thật.

Phím tắt trong REPL

• Tab — đổi mode
• Ctrl+P — xuống dòng (nhập nhiều dòng)
• Esc — dừng AI đang chạy (khi rảnh: xoá dòng đang gõ)
• /exit, /logout — thoát
• /mode — đổi mode (tương đương Tab, dùng khi gõ lệnh)
• /skill — liệt kê skill; /skill new <tên> — tạo skill mẫu
• /memory <nội dung> — ghi thêm vào bộ nhớ dài hạn

Sandbox

aidev --sandbox=./my-project

Khi có sandbox, AIDEV tự cd vào thư mục đó và toàn bộ tool (bash/đọc/ghi/sửa file) chỉ thao tác trong phạm vi này. Có thể đặt cố định trong config.toml bằng sandbox = "duong/dan".

Auto-update

Mỗi lần chạy, AIDEV kiểm tra file version.txt trên GitHub (biến môi trường AIDEV_VERSION_URL để đổi URL repo thật của bạn). Nếu khác bản đang cài, tự chạy npm install -g @hdquan/aidev@latest.

Tắt bằng:

aidev --autoupdate=false

hoặc đặt autoupdate = false trong config.toml.

Skill

~/.aidev/skill/<skill_name>/skill.md

Nội dung mỗi skill.md được nạp vào system prompt của AI. Quản lý qua lệnh aidev skill / aidev skill new <tên>.

Cấu trúc thư mục dữ liệu

~/.aidev/
  config/config.toml   # cấu hình provider/model/apikey/...
  session/             # lịch sử từng phiên (json)
  memory/memory.md      # bộ nhớ dài hạn (vĩnh viễn)
  skill/<name>/skill.md # skill người dùng tự định nghĩa

Provider hỗ trợ

Bất kỳ provider nào tương thích chuẩn OpenAI /v1/chat/completions (OpenAI, OpenRouter, Groq, DeepSeek, Together, Fireworks, Mistral, xAI, Ollama, Azure OpenAI, Google Gemini OpenAI-compat...) hoặc chuẩn Anthropic /v1/messages. Chọn Custom (OpenAI-compatible format) để tự nhập base URL bất kỳ theo chuẩn OpenAI.

Build từ source

npm install
npm run build   # biên dịch TypeScript -> dist/
npm link        # test lệnh `aidev` cục bộ

Publish lên npm

npm run build
npm publish