HERDR HANDBOOK · VI

Codex Integration

Cài Herdr hook cho Codex, hiểu session identity và cơ chế native resume sau server restart.

Official integrations Agents Session state

1. Tại sao cần Codex integration

Herdr tự detect Codex khi nó chạy trong pane. Integration bổ sung native session identity để Herdr có thể resume đúng Codex conversation sau server restart.

2. Cài integration

# Codex nên được chạy ít nhất một lần trước
codex --version
ls -la ~/.codex

# Cài Herdr hook
herdr integration install codex

Herdr dùng ~/.codex mặc định, hoặc $CODEX_HOME nếu biến này được đặt.

3. Kiểm tra

herdr integration status
herdr integration status --outdated-only

Native restore của Codex yêu cầu integration tương thích với Herdr đang chạy. Hãy kiểm tra herdr integration status thay vì ghi nhớ một số version cố định.

4. Native resume hoạt động thế nào

Codex đang chạy └─ integration báo session identity ↓ Herdr server restart └─ process cũ mất ↓ Herdr restore pane + gọi resume command └─ Codex conversation tiếp tục

Không giống detach

Detach không cần resume vì process Codex chưa chết. Resume chỉ quan trọng khi server thật sự restart/stop.

5. Workflow đơn giản

cd ~/projects/my-project
herdr

# Trong pane
codex

# Ngoài TUI có thể xem agent
herdr agent list
herdr agent get <pane-id>

← Workspace / Tab / Pane Daily Workflow →