Cài 1 dòng. Chạy bất cứ đâu. 50+ plugin sẵn. Bot-ready contract.
Multi-provider (AHV Router / ChatGPT Codex / Claude Pro / Grok Premium / mọi OpenAI-compat) · Tool-calling native · Session persist + resume · JSONL adapter cho Telegram/automation bot.
Cài đặt → · Bot integration → · Docs → · Releases →
⚡ Cài
curl -fsSL https://ahvclaw.com/install.sh | bash
Yêu cầu Node ≥22. Cần API key AHV Router — xin miễn phí tại ahvclaw.com/apply.
🎯 Dùng
ahv "task" # one-shot chat
ahv web # web UI local :3080
ahv update # pull latest + rebuild
ahv --version # ahv v0.2.0-p2 (commit c4b1b07, dsh 0.1.1-rc.1)
🔌 Plugin cài sẵn
Base bundle của dsh mang ~40 plugin core (bash, fs, web, subagent, todo, plan, skill, workflow). AHV thêm 11 plugin cho toolbelt xịn ngay từ đầu:
| Nhóm | Plugin | Mục đích |
|---|
| 🖥 Terminal | dsh-terminal, -terminal-bash, -tool-terminal | Persistent PTY session — SSH lâu dài, tmux-flow, long-running scripts. 6 tool. |
| 🧬 Self-modify | cordis-host-runner, tool-cordis | Agent inspect + mount plugin ad-hoc in-memory. 5 tool. |
| 🛒 Plugin Market | dshmarket | Browse + one-click install 1.5k+ community plugin. Web mode. |
| 🦸 Superpowers | superpowers-dsh | 14 curated skill: TDD, debugging, planning, git-worktrees, code-review flow. |
| 🔑 Subscriptions | dsh-plugin-subscriptions | ChatGPT Codex / Claude Pro / Grok Premium làm LLM provider — không cần API key thêm. |
| 🤖 Bot adapter | bot-runner, bot-startup | JSONL streamer cho Telegram/automation. Contract pin theo git tag. |
| 🌐 Browser runtime | @anweat/dsh-browser | Self-contained Playwright + OpenCLI, 15+ tool (open/click/type/screenshot/scroll/fill/execute/auth). Headless-friendly. |
Full catalog live tại ahvclaw.com/admin — auto-track version pinned vs latest mỗi 6h, badge stale/latest cho từng plugin.
🔑 Subscription providers (không cần API key)
Đã có ChatGPT Pro/Codex, Claude Pro, Grok Premium? Login OAuth 1 lần qua browser:
ahv login url grok # trả URL, mở browser
ahv login status --json # {providers: {grok: {logged_in: true, ...}}}
ahv models list --json # thấy grok-4.6, grok-4.5, ... trong catalog
ahv "reply just OK" --model grok-4.6
Model của subscription auto-mount vào harness sau login, ahv models list --json cover full 15+ model từ mọi provider.
ahv login usage --json [--max-age SEC] xem hạn mức mọi tài khoản và giữ hành vi làm mới token sắp hết hạn. ahv login quota --json --kind K [--account KEY] [--max-age SEC] chỉ hỏi tài khoản của claude, codex, grok hoặc antigravity được chọn, không làm mới token; token hết hạn trả hàng lỗi. Các trường mức provider của quota lấy từ hàng mặc định nếu được chọn, nếu không từ hàng đầu tiên được chọn. Hai lệnh dùng chung cache và thời gian giữ sau HTTP 429; quota --max-age 0 hỏi lại nếu tài khoản không đang bị giữ. Kind hoặc account không tồn tại trả JSON lỗi, mã thoát khác 0 và không gửi request.
🤖 Cho bot / automation
Pin git tag → JSONL contract stable, bot integrate như engine thứ 4 ngang Claude Code / Codex / Grok:
git -C ~/.ahv/src checkout v0.2.0-p2
ahv run --prompt-file X --cwd DIR --output jsonl --session-id ID --no-color --no-banner
Event taxonomy: session_meta → assistant_delta → tool_status → assistant_final → turn_end → error {code, terminal, retry_after_sec, message}
Error codes: missing_credential · not_logged_in · quota_limit · rate_limit · network_transient · model_unavailable · context_too_large · permission_denied · tool_error · internal_error
Exit codes: 0 completed · 1 terminal · 2 recoverable · 124 SIGTERM
Full contract chi tiết: Releases v0.2.0-p2 →
🔄 Update tự động
ahv update tự pull latest commit + tag, cài lại deps, rebuild lib, refresh skin, bake version file. Không phải re-clone.
$ ahv update
[ahv update] pulling latest từ github.com/tranhieu860/AHVclaw
Fast-forward — 3 files changed, 98 insertions(+), 26 deletions(-)
✓ built in 2.8s
[ahv update] done → v0.2.0-p2
Rollback dễ: git -C ~/.ahv/src reset --hard v0.2.0-p1 && pnpm install.
📊 So với các CLI khác
| AHV CLI | Claude Code | Codex CLI | Gemini CLI |
|---|
| Cài | curl 1 dòng | curl 1 dòng | npm | brew/npm |
| Provider | Multi (5+ router) | Anthropic only | OpenAI only | Google only |
| Subscription login | ✅ Grok/Codex/Claude | — | ✅ Codex | — |
| Plugin ecosystem | 50+ (dshmarket 1.5k+) | — | — | — |
| Persistent PTY | ✅ | — | — | — |
| Session resume | ✅ genuine | ✅ | ✅ | ✅ |
| Bot JSONL contract | ✅ pin tag | — | — | — |
| Tiếng Việt-first | ✅ | — | — | — |
🌐 Links
📁 Về repo này
Soft-fork của DeepSeek Harness (dsh) — giữ nguyên workspace/vendor upstream để merge không xung đột.
AHV overlay ở:
packages/bundle/ahv/ — bundle config (LLM router, persona, plugin insert, bot runner)scripts/prod/ — deployment snapshots (install.sh, wrapper, systemd, admin backend)apps/cli/ — ahv bin alias
Phần còn lại (vendor/ docs/ examples/ python/ native/ website/ patches/) là upstream — hide khỏi GitHub language stats qua .gitattributes.
Xem PULLING_UPSTREAM.md cho quy trình merge upstream. Full dev doc: AGENTS.md.
📜 License
MIT (giữ nguyên upstream). "DeepSeek Harness" là trademark của DeepSeek — AHV dùng tên "AHV" cho fork, không dùng trademark trực tiếp.
Made with ❤ by Hiếu · Vietnam
