Quản lý phiên

Termote sử dụng tmux windows cho các phiên liên tục tồn tại qua ngắt kết nối.

Phiên mặc định

Cài đặt mới bắt đầu với một phiên Shell duy nhất. Tạo thêm phiên khi cần cho các workflow khác nhau (ví dụ: Claude Code, Copilot, builds).

Quản lý phiên

Desktop

• Chuyển: Click vào phiên trong sidebar bên trái
• Sửa: Double-click tên phiên, hoặc hover và click icon bút chì
• Xóa: Hover và click icon X (cần 2+ phiên)
• Thêm: Click ”+ Add session” ở dưới cùng

Mobile

• Chuyển: Vuốt phải để mở sidebar, chạm vào phiên
• Sửa: Vuốt trái trên phiên, chạm Edit
• Xóa: Vuốt trái trên phiên, chạm Remove
• Thêm: Chạm ”+ Add session” trong sidebar

Tính năng phiên

Tính năng	Mô tả
Icon tùy chỉnh	Chọn emoji icon cho mỗi phiên
Đổi tên	Đổi tên phiên bất cứ lúc nào
Tự động đồng bộ	Phiên đồng bộ giữa các trình duyệt mỗi 5 giây
Lưu trữ	Phiên được lưu bởi tmux windows

Mẹo

Phiên tồn tại qua ngắt kết nối mạng. Kết nối lại để tiếp tục từ chỗ đã dừng.

Lệnh tmux

# Liệt kê windows (phiên)
tmux list-windows

# Tạo window mới
tmux new-window -n myproject

# Chuyển sang window
tmux select-window -t 0

# Kill window
tmux kill-window -t 0

API Endpoints

Phiên được quản lý qua tmux-api:

Endpoint	Method	Mô tả
/api/tmux/windows	GET	Liệt kê tất cả phiên
/api/tmux/new?name=X	POST	Tạo phiên
/api/tmux/select/{id}	POST	Chuyển phiên
/api/tmux/rename/{id}?name=X	POST	Đổi tên phiên
/api/tmux/kill/{id}	POST/DELETE	Xóa phiên

Xử lý sự cố

Phiên không lưu trữ

1. Kiểm tra tmux đang chạy: tmux list-windows
2. Xác minh ttyd sử dụng cờ -A (attach-or-create)
3. Kiểm tra log container: docker logs termote hoặc podman logs termote

Lỗi WebSocket

1. Kiểm tra log container: docker logs termote hoặc podman logs termote
2. Xác minh ttyd đang chạy trên cổng 7681
3. Kiểm tra API health: curl http://localhost:7680/api/tmux/health