GitHub - simple10/agents-observe: Giám sát thời gian thực cho phiên mã Claude & đa tác nhân.

Tổng quát

agents-observe cung cấp bảng điều khiển giám sát thời gian thực cho các tác nhân mã Claude, bao gồm khả năng lọc mạnh mẽ, tìm kiếm và hiển thị các phiên làm việc của đa tác nhân.

Image 1: Claude Observe Dashboard Demo

Video demo

Image 2: Claude Observe Dashboard Screenshot - Expanded Row

Máy chủ và bảng điều khiển có thể chạy cục bộ hoặc từ xa, cho phép nhiều phiên bản Claude Code ghi lại dữ liệu phiên đấy đủ thông qua hooks.

Cài đặt Plugin

Yêu cầu

Docker (bắt buộc — máy chủ chạy dưới dạng container)
Node.js (bắt buộc — scripts hook chạy qua node)

Cài đặt

Thêm marketplace:

claude plugin marketplace add simple10/agents-observe

Cài đặt plugin:
```
claude plugin install agents-observe
```
Khởi động lại Claude Code.

Sau đó, server sẽ tự động khởi động dưới dạng container Docker và bắt đầu ghi nhận sự kiện từ hooks. Mở http://localhost:4981 để xem bảng điều khiển.

Kỹ năng Plugin

Kỹ năng	Mô tả
`/observe`	Mở URL bảng điều khiển và kiểm tra server có chạy không
`/observe status`	Kiểm tra sức khỏe server và hiển thị URL bảng điều khiển

Tại sao giám sát lại quan trọng

Khi Claude Code chạy tự động — tạo ra các tác nhân phụ, gọi công cụ, đọc file, thực thi lệnh — khó có thể nhìn thấy hết những gì đang diễn ra. Claude Observe ghi lại mọi sự kiện hook khi nó xảy ra và truyền vào bảng điều khiển trực tiếp.

Điều này quan trọng vì:

Công việc đa tác nhân mờ mịt. Khó quan sát chi tiết các tác vụ không có giám sát đầy đủ.
Các lệnh công cụ là thực tế. Giám sát chi tiết lệnh cho biết sự thật.
Gỡ lỗi như du hành thời gian. Theo dõi các sự kiện để hiểu rõ toàn bộ chuỗi hành động.

Bạn có thể làm gì

Xem luồng các lệnh công cụ theo thời gian thực.
Thấy được toàn bộ cấu trúc của tác nhân.
Lọc và tìm kiếm sự kiện theo các tiêu chí cụ thể.

Kiến trúc

Claude Code Hooks  → observe_cli.mjs  → API Server (SQLite)  → React Dashboard

Scripts hooks đọc sự kiện raw và gửi tới server. Server phân tích và lưu trữ dữ liệu, chuyển tiếp tới các client WebSocket. Bảng điều khiển React xử lý hiển thị dựa trên luồng sự kiện.

Cài đặt với Standalone

1. Clone và cài đặt phụ thuộc

git clone https://github.com/simple10/agents-observe.git agents-observe
cd agents-observe
brew install just
just start

2. Cấu hình hooks cho Claude Code

just setup-hooks my-project

Copy đoạn cấu hình này vào .claude/settings.json của bạn.

3. Xác minh hoạt động

just health
just test-event

Truy cập http://localhost:5174 (dev) hoặc http://localhost:4981 (Docker). Bạn sẽ thấy sự kiện thử nghiệm xuất hiện.

Lộ trình

Hỗ trợ Codex
Hỗ trợ OpenClaw
Hỗ trợ pi-code agents

Giải quyết sự cố

Nếu gặp phải vấn đề với Docker hoặc hooks, hãy kiểm tra lại cấu hình và việc hoạt động của server thông qua các lệnh kiểm tra có sẵn.