Grok Build Manager

Giao diện web cục bộ để quản lý Grok Build CLI: project, session, agent run, permission, sandbox, Git changes, worktree, MCP, plugin, skill, hook và usage estimate.

Dự án cộng đồng độc lập, không phải sản phẩm chính thức của xAI. “Grok” và các nhãn hiệu liên quan thuộc chủ sở hữu tương ứng.

Yêu cầu

• Node.js 20 trở lên.
• Git.
• Grok Build CLI có lệnh grok trong PATH.
• Tài khoản Grok có quyền sử dụng CLI.

Cài đặt

git clone https://github.com/Rylaispirit/grok-build-manager.git
cd grok-build-manager
npm install

Đăng nhập Grok CLI

Chat và agent run cần đăng nhập trước:

grok login

Các lựa chọn khác:

grok login --oauth
grok login --device-auth

Kiểm tra trạng thái:

grok models

Nếu thành công, CLI sẽ in model mặc định và danh sách model. UI vẫn mở khi chưa login nhưng không thể chạy prompt.

Chạy ứng dụng

npm start

Mở http://127.0.0.1:4173. Giữ terminal chạy trong suốt thời gian sử dụng.

Hướng dẫn chi tiết: docs/USAGE.md.

Kiểm thử

npm test
npm audit --omit=dev

An toàn

• Server chỉ bind 127.0.0.1, không mở ra mạng LAN.
• Không có endpoint shell tùy ý; lệnh CLI và Git được allowlist.
• Xóa session, discard file, xóa MCP và worktree đều yêu cầu xác nhận.
• API key và secret không được ứng dụng lưu.
• Permission mode, sandbox profile và allow/deny rules được truyền vào từng agent run.

Xem chính sách tại SECURITY.md.

Chia sẻ và bản quyền

Dự án dùng giấy phép MIT. Người khác được phép sử dụng, sửa đổi và phân phối lại, nhưng phải giữ nguyên thông báo bản quyền và nội dung giấy phép.

Trước khi public repo:

1. Chạy git status và kiểm tra không có secret, token hoặc log riêng tư.
2. Không commit .grok-manager/, node_modules/ hoặc file cấu hình chứa credential.
3. Giữ lại LICENSE và NOTICE.md.
4. Khi tạo fork, cập nhật URL clone nếu cần.

Đóng góp

Xem CONTRIBUTING.md.