Hive

Bộ điều phối AI agent mã nguồn mở cho lập trình song song trên nhiều dự án.

Chạy các phiên Claude Code, OpenCode và Codex song song. Một cửa sổ. Nhánh cô lập. Không hỗn loạn tab.

Mục Lục

Hive là gì?
Tính năng
Tại sao chọn Hive?
Cài đặt
Khởi động nhanh
Kết nối - Bước ngoặt
Ảnh chụp màn hình
Cộng đồng & Hỗ trợ
Lộ trình
Phát triển
Đóng góp
Giấy phép

Hive là gì?

Nếu bạn chạy nhiều AI coding agent trên các dự án và nhánh khác nhau, bạn hiểu nỗi khổ -- sáu tab terminal mở, không nhớ agent nào đang làm việc gì, và lo lắng hai trong số chúng đang sửa cùng một file.

Hive là bộ điều phối AI agent. Xem tất cả agent đang chạy trong một thanh bên, click để chuyển đổi giữa chúng, và mỗi agent chạy trên một nhánh worktree git cô lập nên không thể xung đột. Kết nối nhiều repository lại để một phiên agent duy nhất có ngữ cảnh trên toàn bộ stack công nghệ của bạn.

Tính năng

🌳 Quy trình làm việc Worktree-First

Làm việc trên nhiều nhánh đồng thời mà không cần stash hay switch. Tạo, lưu trữ và tổ chức worktree chỉ bằng một click. Mỗi worktree được đặt tên thành phố duy nhất để dễ nhận biết.

🤖 Phiên lập trình AI tích hợp

Chạy AI coding agent trực tiếp trong Hive với hỗ trợ OpenCode, Claude Code và Codex. Xem phản hồi theo thời gian thực, theo dõi tool call thực thi, và phê duyệt quyền khi cần. Hỗ trợ undo/redo đầy đủ giúp bạn luôn kiểm soát.

📁 Trình duyệt file thông minh

Xem thay đổi tức thì với chỉ báo trạng thái git trực tiếp. Xem diff inline, duyệt lịch sử file, và điều hướng codebase mà không rời ứng dụng. Trình soạn thảo Monaco tích hợp cung cấp trải nghiệm VS Code đầy đủ.

🔧 Tích hợp Git hoàn chỉnh

Commit, push, pull và quản lý nhánh trực quan. Không cần terminal cho các thao tác git thông thường. Xem thay đổi đang chờ, file đã stage và lịch sử commit tất cả trong một nơi.

📦 Space để tổ chức

Nhóm các dự án và worktree liên quan vào workspace logic. Ghim mục yêu thích để truy cập nhanh. Giữ môi trường phát triển gọn gàng khi bạn mở rộng.

⚡ Bảng lệnh

Điều hướng và hành động nhanh với phím tắt. Nhấn Cmd+K để truy cập bất kỳ tính năng nào ngay lập tức. Tìm kiếm phiên, chuyển worktree, hoặc chạy lệnh mà không cần chuột.

🎨 Giao diện đẹp

Chọn từ 10 theme được thiết kế cẩn thận — 6 tối và 4 sáng. Chuyển đổi ngay lập tức phù hợp với sở thích hoặc thời điểm trong ngày. Tự động theo theme hệ thống nếu muốn.

🖥️ Language Server Protocol

Tích hợp LSP đầy đủ với language server cho từng worktree. Nhận code completion thông minh, go-to-definition, hover tooltip và diagnostics thời gian thực cho TypeScript, Python, Go, Rust và nhiều hơn nữa.

🔌 Kết nối Worktree

Kết nối hai worktree lại để chia sẻ ngữ cảnh, so sánh implementation, hoặc cộng tác thời gian thực. Hoàn hảo cho việc review thay đổi giữa các nhánh, chia sẻ phiên AI giữa worktree, hoặc duy trì tính nhất quán khi làm việc trên các tính năng liên quan. Xem cập nhật trực tiếp khi worktree được kết nối thay đổi.

Tại sao chọn Hive?

Xem cách Hive biến đổi quy trình git của bạn:

Tác vụ	Quy trình truyền thống	Với Hive
Chuyển nhánh	`git stash` → `git checkout` → `git stash pop`	Click vào worktree → Xong
Làm nhiều tính năng	Stash liên tục và chuyển ngữ cảnh	Mở nhiều worktree cạnh nhau
Tạo worktree	`git worktree add ../project-feature origin/feature`	Click "Worktree Mới" → Chọn nhánh
Hỗ trợ AI coding	Terminal + công cụ AI riêng + copy/paste	Phiên AI tích hợp với đầy đủ ngữ cảnh
Xem thay đổi file	`git status` → `git diff file.ts`	Cây trực quan với diff inline
So sánh nhánh	Nhiều tab terminal, copy/paste qua lại	Kết nối worktree để chia sẻ ngữ cảnh
Tìm worktree	`cd ~/projects/...` → nhớ tên thư mục	Tất cả worktree trong một thanh bên
Dọn d��p worktree	`git worktree remove` → `rm -rf directory`	Click "Lưu trữ" → Xử lý mọi thứ

Cài đặt

🍎 Chỉ macOS — Hỗ trợ Windows và Linux sắp ra mắt.

Qua Homebrew (Khuyến nghị)

brew tap morapelker/hive
brew install --cask hive

Tải trực tiếp

Tải file .dmg mới nhất từ GitHub Releases.

Vậy thôi! Mở Hive từ thư mục Applications và trỏ đến git repo.

Khởi động nhanh

Bắt đầu trong dưới 2 phút:

1️⃣ Thêm dự án đầu tiên

Mở Hive → Click "Thêm Dự Án" → Chọn bất kỳ git repository nào trên máy

2️⃣ Tạo Worktree

Chọn dự án → Click "Worktree Mới" → Chọn nhánh (hoặc tạo mới)

3️⃣ Bắt đầu lập trình với AI

Mở worktree → Click "Phiên Mới" → Bắt đầu lập trình với OpenCode, Claude hoặc Codex

💡 Mẹo chuyên gia: Nhấn Cmd+K bất cứ lúc nào để mở bảng lệnh và điều hướng nhanh!

📖 Đọc hướng dẫn đầy đủ | ⌨️ Phím tắt

🔌 Kết nối Worktree - Bước ngoặt

Tính năng Kết nối Worktree của Hive cho phép bạn liên kết hai worktree lại với nhau, tạo cầu nối giữa các nhánh hoặc tính năng khác nhau. Điều này cực kỳ mạnh mẽ cho quy trình phát triển cần nhận biết giữa các nhánh.

Kết nối Worktree là gì?

Kết nối bất kỳ hai worktree nào để:

🔄 Chia sẻ ngữ cảnh - Truy cập file và thay đổi từ nhánh khác ngay lập tức
🤝 Cộng tác - Làm việc trên tính năng liên quan với cập nhật trực tiếp giữa các worktree
📊 So sánh - Xem khác biệt giữa các implementation cạnh nhau
🎯 Tham chiếu - Giữ nhánh chính hiển thị trong khi làm việc trên tính năng
🔗 Liên kết tính năng - Kết nối nhánh frontend và backend cho phát triển full-stack
💬 Chia sẻ phiên AI - Tiếp tục cuộc trò chuyện AI giữa các worktree khác nhau

Cách hoạt động

Chọn Worktree nguồn - Chọn worktree bạn đang làm việc
Kết nối đến đích - Click biểu tượng kết nối và chọn worktree khác
Liên kết hai chiều - Cả hai worktree đều nhận biết lẫn nhau
Cập nhật thời gian thực - Xem thay đổi trong worktree được kết nối khi chúng xảy ra

Tính năng kết nối

✅ Đồng bộ trực tiếp - Thay đổi file trong một worktree xuất hiện trong bảng kết nối
✅ Chuyển nhanh - Nhảy giữa worktree được kết nối chỉ một click
✅ Xem Diff - So sánh file giữa các worktree được kết nối
✅ Terminal chia sẻ - Chạy lệnh ảnh hưởng cả hai worktree
✅ Chia sẻ ngữ cảnh AI - Phiên AI có thể tham chiếu code worktree được kết nối
✅ Chỉ báo trạng thái - Xem trạng thái build, test và thay đổi trong worktree kết nối
✅ Lịch sử kết nối - Theo dõi worktree nào được kết nối và khi nào
✅ Gợi ý thông minh - Hive gợi ý worktree liên quan để kết nối dựa trên quy trình của bạn

Ví dụ sử dụng

Phát triển tính năng: Kết nối nhánh tính năng với main để đảm bảo tương thích và xem thay đổi của bạn tích hợp thế nào.

Sửa lỗi: Kết nối worktree sửa lỗi với nhánh production để xác minh bản sửa hoạt động đúng ngữ cảnh.

Review code: Kết nối worktree của reviewer và author để thảo luận thay đổi với đầy đủ ngữ cảnh từ cả hai phía.

Phát triển Full-Stack: Kết nối worktree frontend và backend để làm việc trên API và UI đồng thời với phối hợp hoàn hảo.

Tái cấu trúc: Kết nối implementation cũ và mới để đảm bảo tương đồng tính năng trong quá trình refactor lớn.

Xem Hive hoạt động

Demo Hive — điều phối AI agent trên nhiều dự án

Thêm ảnh chụp màn hình

Hive — phiên lập trình AI với git worktree

_{Phiên lập trình AI với quản lý git worktree tích hợp}

_{Tạo và quản lý worktree trực quan}

_{Trình duyệt file với chỉ báo trạng thái git trực tiếp}

_{Giao diện đẹp cho mọi sở thích}

Cộng đồng & Hỗ trợ

Nhận trợ giúp

📖 Đọc tài liệu để xem hướng dẫn chi tiết
🐛 Báo cáo lỗi với các bước tái tạo
💡 Yêu cầu tính năng bạn muốn thấy
💬 Tham gia thảo luận để kết nối với cộng đồng
🔒 Báo cáo lỗ hổng bảo mật một cách có trách nhiệm

Tài nguyên

Hướng dẫn sử dụng — Bắt đầu và hướng dẫn
FAQ — Câu hỏi thường gặp và khắc phục sự cố
Phím tắt — Tham chiếu phím tắt đầy đủ

Lộ trình

🚀 Sắp ra mắt

Hỗ trợ đa nền tảng — Build cho Windows và Linux
Hệ thống plugin — Mở rộng Hive với tích hợp tùy chỉnh
Đồng bộ đám mây — Đồng bộ cài đặt, phiên và mẫu kết nối giữa các thiết bị
Tính năng nhóm — Chia sẻ worktree và cộng tác thời gian thực
Trực quan hóa đồ thị Git — Lịch sử nhánh và merge trực quan
Profiling hiệu năng — Công cụ tích hợp để tối ưu hóa

🎯 Tầm nhìn tương lai

Phát triển từ xa — Phát triển dựa trên SSH và container
Kết nối ba chiều — Kết nối và merge nhiều nhánh trực quan
Tích hợp CI/CD — Giám sát GitHub Actions, GitLab CI, Jenkins
Tự động kết n��i — Tự động kết nối nhánh liên quan theo mẫu
Chế độ review code — Loại kết nối đặc biệt tối ưu cho review
Theo dõi thời gian — Phân tích hoạt động cho từng worktree và kết nối

Muốn ảnh hưởng lộ trình? Tham gia thảo luận hoặc đóng góp!

Phát triển

Yêu cầu

Node.js 20+
pnpm 9+
Git 2.20+ (hỗ trợ worktree)

Cài đặt

git clone https://github.com/anomalyco/hive.git
cd hive
pnpm install
pnpm dev

Terminal Ghostty (Tùy chọn)

Hive bao gồm terminal native tùy chọn được hỗ trợ bởi libghostty của Ghostty. Chỉ cần thiết nếu bạn muốn làm việc trên tính năng terminal nhúng.

Cài đặt:

Build libghostty từ mã nguồn Ghostty (hướng dẫn build):
```
cd ~/Documents/dev
git clone https://github.com/ghostty-org/ghostty.git
cd ghostty
zig build -Doptimize=ReleaseFast
```
Tạo ra macos/GhosttyKit.xcframework/macos-arm64_x86_64/libghostty.a.
Nếu repo Ghostty của bạn ở ~/Documents/dev/ghostty/, build sẽ tìm tự động. Nếu không, đặt đường dẫn:
```
export GHOSTTY_LIB_PATH="/path/to/libghostty.a"
```
Rebuild native addon:
```
cd src/native && npx node-gyp rebuild
```

Nếu libghostty không có sẵn, Hive vẫn build và chạy -- tính năng terminal Ghostty sẽ bị vô hiệu hóa.

Lệnh

Lệnh	Mô tả
`pnpm dev`	Khởi chạy với hot reload
`pnpm build`	Build production
`pnpm lint`	Kiểm tra ESLint
`pnpm lint:fix`	Tự động sửa ESLint
`pnpm format`	Format Prettier
`pnpm test`	Chạy tất cả test
`pnpm test:watch`	Chế độ watch
`pnpm test:e2e`	Test Playwright E2E
`pnpm build:mac`	Đóng gói cho macOS

Kiến trúc

Hive sử dụng mô hình ba tiến trình của Electron với sandbox nghiêm ngặt:

┌─────────────────────────────────────────────────────┐
│                    Main Process                      │
│               (Node.js + SQLite)                     │
│                                                      │
│  ┌──────────┐ ┌──────────┐ ┌───────────────────┐   │
│  │ Database  │ │   Git    │ │  Agent SDK Mgr    │   │
│  │ Service   │ │ Service  │ │  (AI Sessions)    │   │
│  └──────────┘ └──────────┘ └───────────────────┘   │
│                      │                               │
│              ┌───────┴───────┐                       │
│              │  IPC Handlers │                       │
│              └───────┬───────┘                       │
└──────────────────────┼──────────────────────────────┘
                       │ Typed IPC
┌──────────────────────┼──────────────────────────────┐
│              ┌───────┴───────┐                       │
│              │    Preload    │                       │
│              │   (Bridge)    │                       │
│              └───────┬───────┘                       │
└──────────────────────┼──────────────────────────────┘
                       │ window.* APIs
┌──────────────────────┼──────────────────────────────┐
│                 Renderer Process                     │
│              (React + Tailwind)                      │
│                                                      │
│  ┌──────────┐ ┌──────────┐ ┌───────────────────┐   │
│  │ Zustand   │ │ shadcn/  │ │    Components     │   │
│  │ Stores    │ │ ui       │ │  (14 domains)     │   │
│  └──────────┘ └──────────┘ └───────────────────┘   │
└─────────────────────────────────────────────────────┘

Cấu trúc dự án

src/
├── main/                  # Tiến trình Electron chính (Node.js)
│   ├── db/                # Cơ sở dữ liệu SQLite + schema + migration
│   ├── ipc/               # Module xử lý IPC
│   └── services/          # Dịch vụ Git, AI agents, logger, file
├── preload/               # Lớp cầu nối (API window.* có kiểu)
└── renderer/src/          # Ứng dụng React SPA
    ├── components/        # UI tổ chức theo domain
    ├── hooks/             # React hook tùy chỉnh
    ├── lib/               # Tiện ích, theme, helper
    └── stores/            # Quản lý state Zustand

Stack công nghệ

Lớp	Công nghệ
Framework	Electron 33
Frontend	React 19
Ngôn ngữ	TypeScript 5.7
Styling	Tailwind CSS 4 + shadcn/ui
State	Zustand 5
Database	better-sqlite3 (chế độ WAL)
AI	OpenCode, Claude Code, Codex
Git	simple-git
Build	electron-vite

Tài liệu

Tài liệu chi tiết trong docs/:

PRDs -- Yêu cầu sản phẩm
Implementation -- Hướng dẫn kỹ thuật
Specs -- Đặc tả tính năng
Plans -- Kế hoạch triển khai đang hoạt động

Đóng góp

Chúng tôi yêu thích đóng góp! Hive được xây dựng bởi developer, cho developer, và chúng tôi chào đón mọi cải tiến.

Cách đóng góp

🐛 Báo cáo lỗi với các bước tái tạo rõ ràng
💡 Đề xuất tính năng cải thiện quy trình làm việc của bạn
📝 Cải thiện tài liệu để giúp người khác bắt đầu
🎨 Gửi cải tiến UI/UX cho khả năng sử dụng tốt hơn
🔧 Sửa lỗi từ issue tracker của chúng tôi
⚡ T��i ưu hiệu năng ở các đường dẫn quan trọng
🧪 Thêm test để cải thiện coverage
🌐 Dịch ứng dụng sang ngôn ngữ của bạn

Trước khi đóng góp, vui lòng đọc Hướng dẫn đóng góp và Quy tắc ứng xử.

Hướng dẫn đóng góp nhanh

Fork repository
Tạo nhánh tính năng (git checkout -b feature/amazing-feature)
Thực hiện thay đổi
Chạy test (pnpm test) và linting (pnpm lint)
Commit với thông điệp mô tả
Push lên fork của bạn
Mở Pull Request

Xem CONTRIBUTING.md để biết hướng dẫn chi tiết.

Giấy phép

Hive là phần mềm mã nguồn mở được cấp phép theo Giấy phép MIT. Xem file LICENSE để biết chi tiết đầy đủ.

FilesExpand file tree

README.vi.md

Latest commit

History

README.vi.md

File metadata and controls

Hive

Mục Lục

Hive là gì?

Tính năng

🌳 Quy trình làm việc Worktree-First

🤖 Phiên lập trình AI tích hợp

📁 Trình duyệt file thông minh

🔧 Tích hợp Git hoàn chỉnh

📦 Space để tổ chức

⚡ Bảng lệnh

🎨 Giao diện đẹp

🖥️ Language Server Protocol

🔌 Kết nối Worktree

Tại sao chọn Hive?

Cài đặt

Qua Homebrew (Khuyến nghị)

Tải trực tiếp

Khởi động nhanh

1️⃣ Thêm dự án đầu tiên

2️⃣ Tạo Worktree

3️⃣ Bắt đầu lập trình với AI

🔌 Kết nối Worktree - Bước ngoặt

Kết nối Worktree là gì?

Cách hoạt động

Tính năng kết nối

Ví dụ sử dụng

Xem Hive hoạt động

Cộng đồng & Hỗ trợ

Nhận trợ giúp

Tài nguyên

Lộ trình

🚀 Sắp ra mắt

🎯 Tầm nhìn tương lai

Yêu cầu

Cài đặt

Terminal Ghostty (Tùy chọn)

Lệnh

Kiến trúc

Cấu trúc dự án

Stack công nghệ

Tài liệu

Đóng góp

Cách đóng góp

Hướng dẫn đóng góp nhanh

Giấy phép