TermHub: Cổng điều khiển Terminal mã nguồn mở chuyên dụng cho AI Agents

TermHub: Cổng điều khiển Terminal mã nguồn mở chuyên dụng cho AI Agents

Trong bối cảnh phát triển phần mềm hiện đại, sự kết hợp giữa AI và các công cụ dòng lệnh đang mở ra những khả năng tự động hóa mới. TermHub là một công cụ kiểm soát terminal hướng tới AI (AI-native) mã nguồn mở, được thiết kế để tạo ra một vòng khép kín nơi các AI Agent có thể giám sát, điều khiển và thu thập dữ liệu từ các phiên làm việc terminal.

TermHub Intro

TermHub hoạt động như một cánh cổng (gateway), cho phép AI hiểu rõ trạng thái hiện tại của terminal, mở các cửa sổ hoặc tab mới khi cần thiết, và thực thi các lệnh một cách chính xác.

Cơ chế hoạt động và Tính năng chính

TermHub được xây dựng xoay quanh quy trình khép kín sau:

• AI kiểm tra các phiên terminal nào đang mở.
• AI mở cửa sổ hoặc tab mới khi cần thiết.
• AI khởi động hoặc nhắm tới một phiên Codex.
• AI gửi tác vụ vào phiên đó.
• AI chỉ chụp (capture) phần đầu ra mới được tạo ra sau khi gửi lệnh và trả về cho người dùng.

Điều này giúp tối ưu hóa việc xử lý dữ liệu, tránh việc AI phải đọc lại toàn bộ lịch sử lệnh dài dòng mà chỉ tập trung vào thông tin mới nhất.

iTerm2 Integration

Nền tảng được hỗ trợ

TermHub tương thích với các hệ điều hành và ứng dụng terminal phổ biến:

• macOS: Hỗ trợ iTerm2 và Terminal.
• Windows: Hỗ trợ Windows Terminal và Command Prompt (CMD).

Trên Windows, cơ chế focus, gửi, chụp và đóng cửa sổ dựa trên sự kết hợp giữa PowerShell và UI Automation. Chức năng chụp màn hình trên Windows hoạt động dựa trên khả năng truy cập văn bản hiển thị (best-effort).

Cài đặt

Người dùng có thể cài đặt TermHub thông qua npm, Homebrew (trên macOS) hoặc tải trực tiếp từ GitHub Releases.

Sử dụng npm:

npm install -g @duo121/termhub

Sử dụng Homebrew (macOS):

brew tap duo121/termhub https://github.com/duo121/termhub
brew install duo121/termhub/termhub

Cài đặt từ GitHub Releases:

Sau khi giải nén file termhub__macos-arm64.tar.gz hoặc termhub__windows-x64.zip, bạn có thể chạy lệnh --version để kiểm tra.

SDK dành cho nhà phát triển

Một trong những điểm nổi bật của TermHub là việc cung cấp SDK preview, cho phép các nhà phát triển tích hợp khả năng điều khiển terminal trực tiếp vào ứng dụng của mình.

import { createTermhubClient } from "@duo121/termhub/sdk";

const client = createTermhubClient({ app: "iterm2" });
const opened = await client.open({ scope: "tab" });
await client.send({ session: opened.target.handle, text: "echo hello from sdk" });
await client.press({ session: opened.target.handle, key: "enter" });
const output = await client.capture({ session: opened.target.handle, lines: 20 });
console.log(output.text);

Các khả năng cốt lõi của SDK bao gồm:

• Mở/đóng các mục tiêu terminal.
• Tìm và phân giải các phiên terminal.
• Gửi văn bản bàn phím và sự kiện phím (phím đơn, tổ hợp phím, chuỗi phím).
• Mô phỏng thao tác chuột trên macOS.

Các lệnh chính

TermHub cung cấp bộ lệnh phong phú để quản lý terminal:

• open: Mở cửa sổ hoặc tab terminal mới.
• list: Liệt kê các cửa sổ/tab/session đang chạy.
• resolve / find: Thu hẹp mục tiêu từ danh sách mờ sang một phiên cụ thể.
• send: Gửi văn bản và tùy chọn chờ/chụp đầu ra thay đổi trong một bước.
• press: Gửi sự kiện phím thực tế (key, combo, sequence).
• capture: Đọc đầu ra hiển thị hoặc phần thay đổi kể từ lần gửi cuối cùng.
• focus: Đưa cửa sổ/session lên phía trước.
• close: Đóng tab hoặc cửa sổ mục tiêu.

Tính năng Send-To-Capture Delta Loop

TermHub hỗ trợ vòng lặp checkpoint tích hợp sẵn, giúp AI chỉ chụp những đầu ra mới phát sinh sau lệnh send. Cơ chế này lưu trữ checkpoint cho phiên đó trước khi ghi đầu vào, và lệnh send --await-output sẽ chỉ trả về phần kết quả mới phát sinh sau đó. Điều này đặc biệt hữu ích khi nhiều AI Agent hoạt động song song trên các phiên khác nhau mà không xung đột dữ liệu.

TermHub là một công cụ hứa hẹn cho những ai muốn xây dựng các hệ thống tự động hóa phát triển phần mềm sâu sắc hơn, kết hợp sức mạnh của AI với sự linh hoạt của dòng lệnh.