HERDR HANDBOOK · VI

Concepts: hiểu đúng mô hình Herdr

Nắm session, workspace, tab, pane, agent và cách client/server phối hợp trước khi học nhiều command.

Official concepts

1. Herdr là gì

Herdr là terminal workspace/runtime dành cho coding agents. Nó giữ terminal/process trong background server, trong khi client TUI chỉ là giao diện để tương tác.

2. Hierarchy

Session └─ Workspace ├─ Tab │ ├─ Pane → Agent / Process │ └─ Pane → Process └─ Tab └─ Pane

Thành phần	Hiểu đơn giản	Khi dùng
Session	Một runtime namespace	Khi cần tách hoàn toàn môi trường
Workspace	Một project-level container	Mỗi project đang làm
Tab	Một nhóm/layout terminal	AI, Development, Tests, Infra
Pane	Một terminal location	Codex, dev server, logs
Agent	Coding agent Herdr nhận diện	Codex, Claude Code, OpenCode…

3. Server và Client

Server sở hữu panes và process state. Client là UI đang attach vào server.

# Mở/attach client
herdr

# Detach bằng Ctrl+B rồi Q

# Kết thúc server và panes
herdr server stop

Không nhầm detach với stop

Detach giữ process chạy. Stop server sẽ kết thúc các process trong panes.

4. Default session và named session

herdr session list
herdr session attach work
herdr session attach side-project
herdr session stop work
herdr session delete side-project

Ưu tiên dùng workspace trước. Chỉ dùng named session khi muốn runtime/socket/state tách biệt.

5. Agent state

Herdr có thể hiển thị trạng thái agent như workingblockeddoneidle. Nhờ đó bạn biết agent nào cần attention.

← Cài đặt Keyboard & UI →