Grok Build IDE

🇬🇧 English | 🇻🇳 Tiếng Việt

Grok Build IDE là trình soạn thảo mã nguồn tùy chọn dựa trên Code - OSS, tích hợp sẵn giao diện Grok Build Workbench và kết nối với Grok CLI chính thức qua ACP (grok agent stdio). Sản phẩm dành cho người dùng cần đầy đủ Explorer, editor, terminal, Source Control và debug bên cạnh trải nghiệm agent.

Grok Build IDE là repository độc lập. Ứng dụng agent desktop nằm tại nct88/Grok-Build-Desktop.

Phiên bản hiện tại: 1.0.12 — xem build/grok/VERSION.

Tải xuống

Release được phát hành công khai tại GitHub Releases:

Gói	Mục đích	Tải xuống
Inno Setup	Cài đặt đầy đủ trên Windows	Grok-Build-IDE-Setup-1.0.12.exe
Portable EXE	File chạy portable tự giải nén	Grok-Build-IDE-1.0.12-win32-x64-portable.exe
Portable ZIP	Giải nén một lần để sử dụng lâu dài	Grok-Build-IDE-1.0.12-win32-x64-portable.zip
VSIX Update	Cập nhật riêng Grok Build Workbench	grok-build-workbench-1.0.12.vsix
Manifest	Kích thước và SHA-256 của artifact	MANIFEST.json

Trang release: Grok Build IDE v1.0.12.

Các executable Windows hiện chưa được ký Authenticode. SmartScreen có thể cảnh báo trong lần chạy đầu; hãy kiểm tra SHA-256 trong MANIFEST.json trước khi chạy.

Grok Build Desktop và Grok Build IDE khác nhau thế nào?

Trường	Grok Build Desktop	Grok Build IDE (repo này)
Tên sản phẩm	Grok Build Desktop	Grok Build IDE
GitHub	`nct88/Grok-Build-Desktop`	`nct88/Grok-Build-IDE`
Nền tảng	Electron, không dùng Code-OSS	Code - OSS + Grok Build Workbench
Tên Windows / Start Menu	Grok Build (`Grok Build.exe`)	Grok Build IDE (`Grok Build IDE.exe`)
Nên dùng khi	Bạn muốn trải nghiệm agent gọn, không cần toàn bộ IDE	Bạn muốn editor, Explorer, terminal, SCM, debug và agent trong cùng cửa sổ
Engine bắt buộc	Grok CLI	cùng Grok CLI

Hai giao diện dùng chung ranh giới runtime:

Grok Build IDE (Code - OSS)
    → extension: extensions/grok-build-workbench
        → ACP client/controller
            → grok agent stdio
                → ~/.grok (xác thực, phiên và cấu hình CLI)

Tính năng chính

Môi trường phát triển Code - OSS

Explorer, editor nhiều tab, tìm kiếm và điều hướng mã nguồn.
Terminal tích hợp, Source Control, diff editor và debug surface.
Hệ thống command, settings, keybinding và extension của Code - OSS.
Kho tiện ích Open VSX trong Extensions view, kèm liên kết trực tiếp grok-build-ide:extension/publisher.name và lệnh Grok Build: Install Extension from Link… (chấp nhận id, URL Open VSX hoặc itemName của Visual Studio Marketplace).
Nhận diện sản phẩm, icon, installer và thư mục dữ liệu riêng với VS Code.

Grok Build Workbench

Chat với Grok CLI qua ACP ngay trong sidebar.
Hiển thị Markdown, thinking, recap/last-turn, tool activity, trạng thái lượt chạy và lỗi. Resume phiên khôi phục summary_text an toàn, không lộ payload mã hóa.
Menu / giống TUI (recap, rewind, imagine, effort, skills local) trong composer.
Chọn permission mode, model, reasoning effort và session mode.
Tạo phiên mới, xem danh sách session, nạp/tiếp tục session và đổi tên session.
Theo dõi file agent mở/chỉnh sửa; có thể mở diff khi agent sửa tệp.
Reverse filesystem/terminal RPC được giới hạn theo workspace và policy.
Lối tắt cho MCP, worktree, plugin, login/logout, doctor và CLI config.
Hiển thị context token, usage tài khoản và liên kết quản lý usage an toàn.
Hỗ trợ theme sáng/tối và giao diện responsive trong sidebar hẹp.

Chuyển đổi giữa hai sản phẩm

Open Grok Build mở Grok Build Desktop (Grok Build.exe).
Open Grok Build IDE quay lại giao diện IDE.
Product surface mặc định của package IDE là grok-build-ide.
Agent-first layout trong IDE là tùy chọn; lựa chọn gần nhất được ghi nhớ.

Yêu cầu hệ thống

Người dùng

Windows x64 cho các artifact phát hành hiện tại.
Grok CLI đã được cài và xác thực.
Quyền đọc/ghi đối với workspace đang mở theo chính sách đã chọn.

Kiểm tra CLI trước khi chạy IDE:

grok --version
grok login
grok doctor

Extension tìm CLI theo cấu hình grokBuild.executablePath, PATH và vị trí cài đặt người dùng phổ biến của Grok CLI.

Phát triển và đóng gói

Node.js theo .nvmrc — hiện là 24.15.0.
npm 11 đi kèm Node.js trong .nvmrc và toolchain Code - OSS.
Windows SDK/toolchain cần thiết cho phần native của Code - OSS.
.NET SDK cho portable single-file launcher.
Inno Setup cho installer Windows.
Một base release candidate hợp lệ khi dùng pipeline tái sử dụng payload.

Cài đặt và bắt đầu nhanh

Cách 1: Inno Setup

Tải Grok-Build-IDE-Setup-1.0.12.exe.
Đối chiếu checksum với MANIFEST.json.
Chạy installer.
Mở Grok Build IDE từ Start Menu.
Chọn Open Folder và mở workspace.
Mở Grok Build Workbench ở sidebar, kiểm tra mode/quyền rồi kết nối.

Đường dẫn cài mặc định:

%LOCALAPPDATA%\Programs\Grok Build IDE\Grok Build IDE.exe

Cách 2: Portable ZIP

Tải và giải nén ZIP vào một thư mục cố định.
Chạy Grok Build IDE.exe.
Không di chuyển riêng executable ra khỏi payload vì Electron cần các DLL và thư mục resources đi kèm.

Cách 3: Portable EXE

Portable EXE tự giải nén payload vào cache theo version rồi khởi chạy IDE. Cách này thuận tiện để thử nhanh; ZIP phù hợp hơn khi dùng thường xuyên.

Cấu hình Grok quan trọng

Mở Settings và tìm Grok Build hoặc chỉnh các key sau:

Setting	Ý nghĩa
`grokBuild.defaultProduct`	Product surface mặc định
`grokBuild.agentFirstLayout`	Bật layout ưu tiên agent trong IDE
`grokBuild.executablePath`	Đường dẫn tùy chỉnh đến Grok CLI
`grokBuild.extraArguments`	Tham số CLI bổ sung
`grokBuild.autoStart`	Tự kết nối khi extension kích hoạt
`grokBuild.model`	Model mặc định
`grokBuild.reasoningEffort`	Mức reasoning mặc định
`grokBuild.permissionMode`	Chính sách xin quyền/chạy tool
`grokBuild.sandbox`	Chế độ sandbox của agent
`grokBuild.tools`	Danh sách tool cho phép
`grokBuild.deniedTools`	Danh sách tool bị từ chối
`grokBuild.worktree`	Bật hoặc cấu hình worktree
`grokBuild.experimentalMemory`	Bật tính năng memory thử nghiệm
`grokBuild.disableWebSearch`	Tắt web search khi cần
`grokBuild.rules`	Rules truyền cho agent
`grokBuild.maxTurns`	Giới hạn số lượt agent
`grokBuild.enableTerminal`	Cho phép reverse terminal host
`grokBuild.allowOutsideWorkspace`	Cho phép truy cập ngoài workspace
`grokBuild.followAgentFiles`	Tự theo file agent đang thao tác
`grokBuild.openDiffOnEdit`	Mở diff khi agent chỉnh sửa
`grokBuild.voiceInput`	Hiển thị voice input khi runtime hỗ trợ

Không đặt token hoặc credential vào setting đồng bộ/chia sẻ. Xác thực chính vẫn thuộc Grok CLI.

Chạy từ mã nguồn

Clone repository, cài dependency và khởi động ứng dụng bằng giao diện npm chuẩn:

git clone https://github.com/nct88/Grok-Build-IDE.git
cd Grok-Build-IDE
npm install
npm start

npm start gọi launcher Code - OSS phù hợp với hệ điều hành, thực hiện prelaunch compile cần thiết và mở Grok Build IDE. Có thể truyền tham số ứng dụng sau --, ví dụ npm start -- .\my-project.

Kiểm tra Grok Build Workbench:

npm run check:grok

Gate này bao gồm:

TypeScript typecheck.
Vitest unit/integration tests.
Production bundle.
Hợp đồng release/branding.
Visual webview scenarios ở light/dark và nhiều kích thước.

Kiến trúc repository

grok-build-ide/
├─ src/                              Code - OSS workbench source
├─ extensions/
│  └─ grok-build-workbench/          ACP controller, webview và Grok UI
├─ build/                            Build scripts và nhận diện sản phẩm
│  └─ grok/VERSION                   Version phát hành Grok Build IDE
├─ resources/                        Icon và tài nguyên theo nền tảng
├─ scripts/
│  ├─ grok-release/                  Release orchestrator/publisher
│  ├─ start-grok-build-ide.mjs       npm start launcher
│  ├─ build-grok-workbench-*.ps1     Tạo payload, launcher và installer
│  └─ verify-*.ps1                   Cổng kiểm tra artifact/runtime
├─ docs/                             Kiến trúc và hướng dẫn vận hành
├─ CHANGELOG.md                      Thay đổi theo phiên bản
├─ product.json                      Product identity của IDE
├─ packaging.json                    Hợp đồng đóng gói
└─ dist/                             Artifact cục bộ theo version

Ranh giới runtime

Code - OSS cung cấp editor shell.
Grok-specific runtime/UI nằm trong extensions/grok-build-workbench.
Grok CLI là child process sở hữu agent loop và kết nối dịch vụ.
Extension không lưu bản sao token Grok trong webview.
ACP file host từ chối đường dẫn ngoài workspace theo mặc định. Quy tắc này không sandbox shell; terminal ngược mặc định tắt và yêu cầu Workspace Trust.

Xem docs/ARCHITECTURE.md.

Build và phát hành

Version phải đồng bộ giữa:

build/grok/VERSION.
extensions/grok-build-workbench/package.json.
Tham số -Version của release command.

Lệnh tạo local candidate (có thể tự chọn base gần nhất):

powershell -NoProfile -ExecutionPolicy Bypass `
  -File scripts\grok-release\build-and-publish.ps1 `
  -Version <semver>

Public release luôn phải truyền base đã kiểm chứng, source sạch và URL HTTPS. Chế độ ký là mặc định; chỉ dùng waiver unsigned khi người phát hành chủ động chấp nhận cảnh báo SmartScreen:

powershell -NoProfile -ExecutionPolicy Bypass `
  -File scripts\grok-release\build-and-publish.ps1 `
  -Version <semver> `
  -BaseCandidateRoot <duong-dan-payload-hop-le> `
  -ReleaseBaseUrl <https-download-root> `
  -AllowUnsignedPublicRelease `
  -PublicRelease

Mỗi version là bất biến; pipeline dừng nếu dist/<version> đã tồn tại.

dist/<version>/
├─ install/
│  └─ Grok-Build-IDE-Setup-<version>.exe
├─ portable/
│  ├─ Grok-Build-IDE-<version>-win32-x64-portable.exe
│  └─ Grok-Build-IDE-<version>-win32-x64-portable.zip
├─ update/
│  ├─ grok-build-workbench-<version>.vsix
│  └─ apply-update.ps1
├─ MANIFEST.json
└─ latest.json

Pipeline release kiểm tra đủ portable EXE, portable ZIP, installer và VSIX trước khi xuất bản metadata. Chế độ public yêu cầu base khớp source/commit và HTTPS; manifest ghi rõ public-signed hoặc public-unsigned. Quy trình chờ CI trước khi tạo tag/Release nằm trong docs/RELEASE.md.

Cập nhật riêng extension

Gói update/ cho phép cập nhật Grok Build Workbench mà không cài lại toàn bộ IDE:

powershell -NoProfile -ExecutionPolicy Bypass `
  -File .\apply-update.ps1 `
  -InstallRoot "$env:LOCALAPPDATA\Programs\Grok Build IDE"

Đóng toàn bộ cửa sổ IDE trước khi cập nhật và mở lại sau khi script hoàn tất.

Kiểm tra artifact cuối

Các script quan trọng:

Script	Mục đích
`scripts/check-grok-brand-assets.ps1`	Kiểm tra bộ nhận diện và icon
`scripts/check-grok-release-contract.mjs`	Kiểm tra version, tên và hợp đồng release
`scripts/verify-portable-extension-registry.ps1`	Kiểm tra extension registry trong payload
`scripts/verify-grok-workbench-portable-settings.ps1`	Kiểm tra portable settings
`scripts/verify-grok-workbench-single-exe.ps1`	Kiểm tra launcher/payload
`scripts/test-grok-workbench-single-exe-runtime.ps1`	Chạy smoke test trên executable cuối

Build thành công không tự chứng minh runtime hoặc giao diện đúng. Release chỉ nên được xem là đã kiểm chứng khi các gate trên chạy với chính artifact cuối.

Bảo mật và quyền riêng tư

Token xác thực thuộc Grok CLI/Extension Host và không được gửi sang webview.
URL bên ngoài phải vượt qua policy HTTPS/localhost phù hợp; URL chứa credential bị từ chối.
Filesystem, editor follow và diff review mặc định bị giới hạn theo workspace.
allowOutsideWorkspace là quyền mở rộng rõ ràng, không nên bật mặc định.
Không commit .env, auth file, cookie database, private key, token hoặc log chứa thông tin cá nhân.
Workspace Trust và portable defaults phải được kiểm tra trên artifact, không chỉ trong source.

Khắc phục sự cố

Grok sidebar không kết nối

grok --version
grok login
grok doctor

Sau đó kiểm tra grokBuild.executablePath và mở lại cửa sổ IDE.

Sidebar không xuất hiện

Mở Activity Bar và chọn Grok Build.
Chạy command Grok Build: Connect hoặc Grok Build: New Session.
Kiểm tra extension grok-build-workbench đã được cài/đăng ký trong profile portable.

Portable EXE khởi động chậm lần đầu

Launcher cần giải nén payload vào cache theo version. Những lần sau sẽ tái sử dụng cache nếu các file quan trọng còn hợp lệ.

Installer/portable hiện SmartScreen

Executable hiện chưa ký số. Chỉ chạy artifact từ release chính thức sau khi SHA-256 khớp MANIFEST.json.

Update VSIX chưa có hiệu lực

Đóng toàn bộ IDE trước khi chạy apply-update.ps1, kiểm tra đúng InstallRoot, sau đó khởi động lại.

Tài liệu liên quan

Tài liệu	Nội dung
`docs/ARCHITECTURE.md`	Kiến trúc Code - OSS/Grok extension
`docs/PRODUCT_IDENTITY.md`	Tên sản phẩm IDE và Desktop
`docs/DEVELOPMENT.md`	Cài dependency, chạy source và kiểm tra
`docs/DISTRIBUTION.md`	Build và phát hành
`CHANGELOG.md`	Thay đổi theo phiên bản
`SECURITY.md`	Chính sách báo cáo vấn đề bảo mật
`CONTRIBUTING.md`	Hướng dẫn đóng góp Code - OSS

Đóng góp

Thay đổi Grok-specific nên tập trung trong extensions/grok-build-workbench, build/grok, scripts/grok-release, tài nguyên nhận diện và tài liệu liên quan.
Không phá vỡ bố cục chuẩn của Code - OSS: src, extensions, build, resources, cli, remote, test.
Chạy gate extension và kiểm tra artifact phù hợp trước khi mở Pull Request.
Không đưa artifact lớn, cache build, secret hoặc dữ liệu người dùng vào commit.
Các vấn đề thuộc Code - OSS upstream nên được đối chiếu với microsoft/vscode.

Nguồn gốc và giấy phép

Repository này được xây dựng trên mã nguồn Code - OSS của Microsoft và giữ bố cục/toolchain tương thích với upstream.

Code - OSS được cấp phép theo LICENSE.txt — MIT License.
Thông báo phụ thuộc bên thứ ba nằm trong ThirdPartyNotices.txt.
Hướng dẫn đóng góp upstream nằm trong CONTRIBUTING.md.

Visual Studio Code là bản phân phối riêng của Microsoft với các tùy chỉnh và giấy phép sản phẩm riêng. Grok Build IDE không phải Visual Studio Code và không được tuyên bố là sản phẩm chính thức của Microsoft.

Grok CLI và các model Grok thuộc chủ sở hữu tương ứng trong hệ sinh thái xAI/Grok. Grok Build IDE là bản tích hợp độc lập sử dụng CLI chính thức qua ACP; không tuyên bố liên kết chính thức nếu chưa có xác nhận bằng văn bản.

Navigation Menu

Repository files navigation

Grok Build IDE

Tải xuống

Grok Build Desktop và Grok Build IDE khác nhau thế nào?

Tính năng chính

Môi trường phát triển Code - OSS

Grok Build Workbench

Chuyển đổi giữa hai sản phẩm

Yêu cầu hệ thống

Người dùng

Phát triển và đóng gói

Cài đặt và bắt đầu nhanh

Cách 1: Inno Setup

Cách 2: Portable ZIP

Cách 3: Portable EXE

Cấu hình Grok quan trọng

Chạy từ mã nguồn

Kiến trúc repository

Ranh giới runtime

Build và phát hành

Cập nhật riêng extension

Kiểm tra artifact cuối

Bảo mật và quyền riêng tư

Khắc phục sự cố

Grok sidebar không kết nối

Sidebar không xuất hiện

Portable EXE khởi động chậm lần đầu

Installer/portable hiện SmartScreen

Update VSIX chưa có hiệu lực

Tài liệu liên quan

Đóng góp

Nguồn gốc và giấy phép

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.eslint-plugin-local		.eslint-plugin-local
.github/workflows		.github/workflows
.grok		.grok
.vscode		.vscode
build		build
cli		cli
docs		docs
extensions		extensions
logo		logo
remote		remote
resources		resources
scripts		scripts
src		src
test		test
.editorconfig		.editorconfig
.env.example		.env.example
.eslint-ignore		.eslint-ignore
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
.vscode-test.js		.vscode-test.js
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.txt		LICENSE.txt
README.en.md		README.en.md
README.md		README.md
SECURITY.md		SECURITY.md
SUPPORT.md		SUPPORT.md
ThirdPartyNotices.txt		ThirdPartyNotices.txt
cglicenses.json		cglicenses.json
cgmanifest.json		cgmanifest.json
eslint.config.js		eslint.config.js
gulpfile.mjs		gulpfile.mjs
package-lock.json		package-lock.json
package.json		package.json
packaging.json		packaging.json
product.json		product.json
tsfmt.json		tsfmt.json

Latest commit

History

Folders and files

Repository files navigation

Grok Build IDE

Tải xuống

Grok Build Desktop và Grok Build IDE khác nhau thế nào?

Tính năng chính

Môi trường phát triển Code - OSS

Grok Build Workbench

Chuyển đổi giữa hai sản phẩm

Yêu cầu hệ thống

Người dùng

Phát triển và đóng gói

Cài đặt và bắt đầu nhanh

Cách 1: Inno Setup

Cách 2: Portable ZIP

Cách 3: Portable EXE

Cấu hình Grok quan trọng

Chạy từ mã nguồn

Kiến trúc repository

Ranh giới runtime

Build và phát hành

Cập nhật riêng extension

Kiểm tra artifact cuối

Bảo mật và quyền riêng tư

Khắc phục sự cố

Grok sidebar không kết nối

Sidebar không xuất hiện

Portable EXE khởi động chậm lần đầu

Installer/portable hiện SmartScreen

Update VSIX chưa có hiệu lực

Tài liệu liên quan

Đóng góp

Nguồn gốc và giấy phép

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages