@noobdemon/noob-cli weekly downloads statistics

<p align="center"> <img src="assets/noob-cli.png"><br/> Một coding agent sống trong terminal. <a href="https://discord.gg/y3pADv5eZt"><img alt="Discord" src="https://img.shields.io/discord/1511668176386130002?label=discord" /></a> <a href="https://www.npmjs.com/package/@noobdemon/noob-cli"><img alt="npm" src="https://img.shields.io/npm/v/@noobdemon/noob-cli"/></a> </p>

---

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á<br/>(chạy tự do, không xin phép):	read_file · list_dir · glob · grep · web_fetch
Thao tác có rủi ro<br/>(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)