🔮 NGHẸO REMOTE

Điều khiển Antigravity IDE từ xa qua web — miễn phí, mã nguồn mở

---

💡 Nghẹo Remote là gì?

Nghẹo Remote là web dashboard cho phép bạn điều khiển Antigravity IDE từ bất kỳ đâu thông qua trình duyệt web.

Antigravity là IDE lập trình AI thế hệ mới (của Google DeepMind / Codeium) — tích hợp AI agent mạnh mẽ, giúp viết code bằng ngôn ngữ tự nhiên. Nhưng bình thường bạn phải ngồi trước máy tính để dùng nó.

Nghẹo Remote giải quyết vấn đề đó:

🎯 Đang ở ngoài đường? Mở điện thoại → vào link → chat với AI, xem nó code, accept/reject thay đổi.

🎯 Muốn bạn bè cùng xem? Gửi link + mật khẩu → họ truy cập ngay, không cần cài gì.

🎯 Quản lý nhiều máy? Mỗi máy chạy Nghẹo Remote → điều khiển tất cả từ 1 chỗ.

---

✨ Tính năng chi tiết

💬 Chat AI từ xa

• Xem toàn bộ lịch sử hội thoại với AI (vượt giới hạn 598 step nhờ hybrid JSON + protobuf)
• Gửi tin nhắn, đính kèm hình ảnh, chọn model AI
• Tạo/xóa conversation trực tiếp
• Hiển thị đẹp: Markdown, syntax highlighting, thinking blocks

🖥️ Quản lý Workspace

• Tự động phát hiện tất cả Antigravity IDE đang chạy trên máy
• Chuyển đổi giữa nhiều workspace
• Mở workspace mới, chạy Headless (không cần IDE UI)

📊 Resource Monitor

• CPU, RAM, Disk — biểu đồ donut realtime
• Theo dõi từng process của mỗi workspace
• Lịch sử 5 phút (sparkline chart)

🔀 Source Control

• Git status với màu sắc (modified, added, deleted, untracked)
• Side-by-side diff viewer với syntax highlighting
• Commit, push, pull ngay trên web
• File explorer với tree view

⚡ Cascade Control

• Xem trạng thái cascade (running, idle, waiting)
• Accept/Reject code changes từ xa
• Auto-accept mode — tự động chấp nhận mọi thay đổi
• Cancel cascade đang chạy

🔒 Bảo mật

• Mật khẩu bảo vệ (AUTH_KEY)
• Cloudflare Tunnel — mã hóa end-to-end
• Rate limiting — chống brute force
• Helmet.js — security headers

🌐 Multi-Server Mode

• Điều khiển nhiều máy chạy Antigravity IDE từ 1 dashboard duy nhất
• Thêm/xóa remote server qua Settings UI
• Tự động phát hiện workspace trên remote server
• Proxy API — mọi tương tác đều đi qua dashboard chính
• Hỗ trợ auth key cho remote servers

👤 Profile Swap

• Chuyển đổi nhanh giữa nhiều tài khoản Google trên cùng 1 máy
• Lưu/khôi phục 3 folder dữ liệu IDE (OAuth, Gemini cache, extensions)
• Graceful close IDE — không mất token đăng nhập
• Hỗ trợ cả macOS và Windows
• Thêm tài khoản mới với flow "Add Account"

---

🚀 Cài đặt

⚡ Một lệnh duy nhất (Khuyến nghị)

macOS / Linux:

curl -sL https://raw.githubusercontent.com/nguyenduchoai/ngheoremote/main/scripts/setup.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/nguyenduchoai/ngheoremote/main/scripts/setup.ps1 | iex

Script sẽ tự động:

1. ✅ Clone repository
2. ✅ Cài đặt dependencies
3. ✅ Cài CLI ngheoremote toàn cục
4. ✅ Hỏi bạn nhập mật khẩu
5. ✅ Tạo link public + QR code

🔧 Cài thủ công

git clone https://github.com/nguyenduchoai/ngheoremote.git
cd ngheoremote
npm run setup
npm link    # Cài lệnh ngheoremote toàn cục

Yêu cầu: Node.js 18+ • cloudflared

---

📖 Sử dụng

🌐 Chạy online — chia sẻ qua internet

ngheoremote serve

App sẽ hỏi mật khẩu, rồi tạo link public miễn phí:

╔══════════════════════════════════════════════════════════╗
║  ✅ READY — Share with your friends!                    ║
╠══════════════════════════════════════════════════════════╣
║  🌐 Public URL:  https://xxx-xxx.trycloudflare.com     ║
║  🔑 Password:    your-password                         ║
╚══════════════════════════════════════════════════════════╝

📱 Scan QR code trên điện thoại hoặc gửi link + mật khẩu cho bạn bè!

🏠 Chạy với domain cố định

ngheoremote serve --tunnel

💻 Chạy local

ngheoremote serve --local

📋 Tất cả lệnh

Lệnh	Mô tả
ngheoremote serve	Chạy online (link public tạm thời)
ngheoremote serve --tunnel	Chạy online (domain cố định)
ngheoremote serve --local	Chạy local (không tunnel)
ngheoremote status	Xem trạng thái dịch vụ
ngheoremote stop	Dừng tất cả
ngheoremote restart	Khởi động lại
AUTH_KEY=xxx ngheoremote serve	Chạy với mật khẩu tùy chỉnh

---

📐 Kiến trúc

┌──────────────────┐                    ┌───────────────┐
│  Antigravity IDE │ ◄── JSON + Proto ──│   Backend     │
│  Language Server │                    │   (Express)   │
└──────────────────┘                    └──────┬────────┘
                                               │ WebSocket
                                        ┌──────┴────────┐
                                        │   Frontend    │
                                        │   (Next.js)   │
                                        └───────────────┘
                                               │
                                        ┌──────┴────────┐
                                        │  Cloudflare   │
                                        │   Tunnel      │
                                        └───────────────┘
                                               │
                                        📱 Phone / 💻 Laptop

---

⚡ Tech Stack

Layer	Technology
Backend	Node.js + Express
WebSocket	ws 8
Protobuf	protobufjs 8
Frontend	Next.js 16 + React 19
Components	shadcn/ui (Radix UI)
Styling	Tailwind CSS 4
Tunnel	Cloudflare (cloudflared)
CLI	Node.js (ngheoremote)

---

📄 License

MIT

_{Made by Nguyễn Đức Hoài}