Epiq: Trình theo dõi vấn đề phân tán dựa trên Git với giao diện dòng lệnh TUI

Các công cụ theo dõi vấn đề (issue tracker) truyền thống thường hoạt động tách biệt khỏi quy trình làm việc của lập trình viên, gây ra sự gián đoạn và trải nghiệm người dùng không tối ưu. Epiq ra đời để giải quyết vấn đề này bằng cách đưa khả năng quản lý công việc vào ngay trong terminal của bạn.

Sự cộng tác đa người dùng được thực hiện thông qua Git, sử dụng nhật ký sự kiện bất biến (immutable event logs) có phạm vi người dùng và hội tụ trong bộ nhớ. Đây là một dự án tâm huyết nhằm tối ưu hóa trải nghiệm nhà phát triển (DevX) trong quản lý dự án.

Tại sao chọn Epiq?

Epiq được thiết kế để tối ưu hóa luồng làm việc (flow) với các tính năng như điều hướng bằng bàn phím, lịch sử lệnh, bộ lọc, tự động hoàn thành và đồng bộ hóa thuần túy qua Git.

Tập trung vào bàn phím

Bạn có thể điều hướng qua các bảng (boards), vấn đề (issues), làn bơi (swimlanes) và ngữ cảnh bằng các phím di chuyển kiểu Vim (hjkl). Hoặc đơn giản là "lừa" bằng cách sử dụng các phím mũi tên.

Phân tán theo mặc định

Epiq sử dụng Git dưới lớp vỏ, với các cây làm việc (worktrees) và nhánh trạng thái (state branches) bị cô lập. Điều này cho phép các đội nhóm cộng tác mà không cần引入 một dịch vụ trung tâm tập trung khác.

Trạng thái có thể truy vết

Các thay đổi được thêm vào dưới dạng sự kiện (events), được phát lại một cách xác định và được thiết kế để hội tụ. Bạn có thể kiểm tra những gì đã xảy ra hôm qua, tuần trước hoặc một năm trước.

Mô hình hoạt động

Ưu tiên cục bộ. Đồng bộ khi muốn. Hoặc tự động.

Bạn có thể tạo, di chuyển, lọc, đóng, mở lại và đồng bộ các vấn đề mà không cần chuyển đổi tab. Epiq giữ cho tương tác cục bộ tức thì trong khi cho phép bạn đồng bộ rõ ràng hoặc tự động.

Ví dụ cách sử dụng bên trong bất kỳ kho Git nào:

# Khởi chạy Epiq
epiq

# Tạo công việc mới
:new issue Add keyboard shortcuts

# Lọc bảng theo thẻ
:filter tag prio

# Đồng bộ trạng thái phân tán
:sync

Những gì bạn sẽ nhận được

1. Không cần tài khoản: Khởi tạo trong một kho Git và tiếp tục làm việc.
2. Bảng Kanban dạng ASCII trực quan: Kanban ngay trong terminal, được điều hướng, lọc và chỉnh sửa nhanh chóng.
3. Cộng tác nhận biết xung đột: Nhật ký sự kiện chỉ thêm (append-only) có phạm vi người dùng giúp ngăn chặn rắc rối khi hợp nhất mã (merge pain) và hội tụ trong bộ nhớ.
4. Tương tác của tác nhân AI: Máy chủ MCP cho phép các công cụ AI tương tác với Epiq theo cách có thể dự đoán được.

Theo dõi vấn đề nên diễn ra mượt mà.

Cài đặt

Bắt đầu chỉ với hai lệnh.

Cài đặt toàn cục, nhập vào bất kỳ kho lưu trữ Git nào và chạy Epiq. Lần chạy đầu tiên sẽ mở trình hướng dẫn thiết lập tương tác.

npm install --global epiq
cd your-existing-repo-with-remote-tracking
epiq

Bạn có thể truy cập kho lưu trữ GitHub để tìm hiểu thêm hoặc đóng góp cho dự án.