Cài đặt

npm install -g @noobdemon/noob-cli

Yêu cầu Node.js ≥ 18 (khuyến nghị 22).

Xác thực

noob-cli đi qua một gateway (Cloudflare Worker) để ẩn backend thật và quản lý API key. Bạn cần một API key để dùng:

noob login nk_xxx_xxxxxxxx     # đăng nhập, key lưu ở ~/.noob/config.json
noob usage                     # xem hạn mức còn lại
noob logout                    # đăng xuất

Trong phiên: /login <key>, /usage, /logout.

Các gói:

| Gói | Hạn mức | | --------- | ----------------------------------------- | | pro | 5 000 request / 5 giờ (cửa sổ trượt) | | proplus | 10 000 request / 5 giờ | | admin | không giới hạn | | trial | 200 request dùng thử, hết là key dead |

[!TIP] Mỗi lệnh gọi mô hình (kể cả từng bước tool trong một tác vụ) tính là 1 request.

Sử dụng

noob                                   # khởi động noob-cli
noob "add input validation to api.js"  # khởi động kèm yêu cầu
noob -m gateway-claude-opus-4-8        # chọn mô hình
noob --yolo                            # tự duyệt edit & lệnh

Các flag: --yolo, --ultra, --model <name>, --continue, --resume, --insecure-tls.

Lệnh trong phiên

| Lệnh | Tác dụng | | --------------------------------- | ------------------------------------------------------ | | /help | danh sách lệnh | | /model [name] /models | đổi mô hình (fuzzy match) · liệt kê theo provider | | /chat | quay lại chế độ chat thường | | /agent on\|off | bật/tắt agent mode (đẻ sub-agent) | | /mode | build|plan|compose — đổi chế độ agent (Ctrl+T cycle) | | /goal [text] | đặt HARD GOAL cho phiên · /goal clear để xoá | | /loop <iv> <task> | chạy task định kỳ · /loop stop để dừng | | /ultra | chế độ tự hành: model tự nghĩ & làm tới khi xong | | /workflow | orchestrate workflow đa-agent (xem /workflow help) | | /kg | knowledge graph của project (xem /kg help) | | /undo | khôi phục file về bản trước khi agent sửa | | /checkpoint [label] /rollback | snapshot & khôi phục nguyên cụm file đã đổi | | /diff [path] | tổng hợp thay đổi trong phiên | | /explain <file\|dir> | tour nhanh 1 file/module, lưu kiến trúc vào KG | | /superlogic <gì> | đọc sâu code, đề xuất tinh gọn — hỏi ý trước khi sửa | | /last | xem bản đầy đủ của tool output gần nhất bị cắt | | /compact | tóm tắt phiên ngay để gọn ngữ cảnh | | /tokens | xem token đã dùng trong phiên | | /memory | xem bộ nhớ noob.md · /memory stats xem kích thước | | /learn | chưng cất bài học vào noob.md | | /init | quét dự án & tạo noob.md | | /karpathy | rà soát code theo nguyên tắc Karpathy | | /frontend-design | skill thiết kế UI frontend chất lượng cao | | /improve | phân tích workspace & gợi ý tính năng cải thiện | | /add-dir <path> | thêm thư mục ngoài cwd vào phạm vi · remove để gỡ | | /cwd | thư mục làm việc hiện tại | | /yolo /auto-yolo | bật/tắt tự duyệt (Shift+Tab) · lưu làm mặc định | | /clear /new | xoá ngữ cảnh / phiên mới | | /continue /resume /sessions | tiếp tục phiên gần nhất · chọn phiên cũ · liệt kê | | /status /version | trạng thái · phiên bản | | /login /logout /usage | xác thực & hạn mức | | /update | tự cập nhật noob | | /exit | thoát (Ctrl+C một lần = dừng turn, hai lần = thoát) |

Tools cho agent

| Hành động | Tool ID | | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | | Đọc/khám phá(chạy tự do, không xin phép): | read_file · list_dir · glob · grep · web_fetch | | Thao tác có rủi ro(xin phép y/n/a, thêm t=hết turn, f=file này khi bật rich TTY): |write_file · edit_file · run_command | | Quản lý tiến trình nền & điều phối: | bg_output · kill_bg · write_todos · spawn_agent / spawn_agents (khi /agent bật) · kg_search / kg_add / kg_link / kg_obs (knowledge graph)|

[!TIP] web_fetch truy cập mạng (http/https) nhưng read-only nên không xin phép. Nó strip HTML bằng regex; với trang render bằng JS (SPA) sẽ trả về gần rỗng kèm gợi ý thử raw:true.

Tuỳ chỉnh

| Env var | Tác dụng | | --------------------- | --------------------------------------------------------------- | | NOOB_API_BASE | ghi đè URL gateway | | NOOB_API_KEY | API key (ghi đè ~/.noob/config.json) | | NOOB_INSECURE_TLS=1 | tắt verify TLS — giải pháp cuối cho máy sau proxy chặn TLS. |

Tương thích Model

Agent điều khiển tool qua một text protocol (gateway không có function-calling gốc). Các model khác nhau về mức độ sẵn lòng tuân theo:

| Provider | Agentic tools | Ghi chú | | ---------------------- | -------------- | ------------------------------------ | | Anthropic (Claude) | ✅ tốt nhất | mặc định — gateway-claude-opus-4-8 | | DeepSeek | ✅ chạy tốt | lựa chọn thay thế tốt | | OpenAI (GPT) | ⚠️ hay từ chối | trả "I can't access your filesystem" |

Dùng Claude hoặc DeepSeek cho edit file & chạy lệnh. Mọi model đều ổn cho chat thường.

Cấu trúc dự án

src/
├── api.js              # gateway client + stream parser + quota warning
├── agent.js            # tool-loop driver, SYSTEM prompt, summarization
├── tools.js            # read/write/edit/list_dir/glob/grep/run_command/web_fetch/bg/kg
├── repl.js             # input loop, slash commands, session state
├── repl/
│   ├── agent-dispatch.js   # spawn_agent + write_todos dispatcher
│   ├── complete.js         # SLASH catalog + autocomplete
│   ├── permission.js       # askPermission (y/n/a/t/f scopes)
│   ├── state.js            # createState — session state shape
│   ├── stream-printer.js   # render stream theo dòng (heading/table/code)
│   ├── todos.js            # parseTodosFromHistory (pure)
│   ├── ultra.js            # ULTRA mode prompt templates
│   ├── workflow-commands.js # /workflow help/list/load/delete (pure)
│   └── commands/           # nhóm slash command tách rời
├── subagent.js         # spawn_agent / spawn_agents — sub-agent isolation
├── workflow-bg.js      # workflow chạy nền
├── workflow-runs.js    # lưu/khôi phục lần chạy workflow
├── workflows.js        # ~/.noob/workflows/ — workflow user lưu
├── workflows-builtin.js # workflow ship-sẵn (deep-research, verify-claims, triage)
├── kg.js               # knowledge graph (.noob/kg.jsonl per project)
├── tui.js              # terminal UI (input, status bar, todo progress)
├── ui.js               # color, markdown renderer, banner
├── diff.js             # render diff khi edit_file
├── config.js           # ~/.noob/config.json (api key, gateway, model)
├── sessions.js         # ~/.noob/sessions/ — save/list/resume
├── skills.js           # skill loader (cwd → package)
├── memory.js           # noob.md per-project agent memory
├── tokens.js           # local token counter (gpt-tokenizer)
├── models.js           # 4-model flagship catalog + fuzzy resolver
├── i18n.js             # bảng chuỗi tiếng Việt
└── update.js           # `noob update` self-updater

tests/                   # vitest unit tests
scripts/                 # smoke tests + notify-discord

License

MIT