
A terminal UI for controlling Mihomo via its HTTP REST API. For learning purposes only.
- Proxies — View proxy groups, switch selector nodes, test delays
- Config — View and modify running configuration (mode, log-level, etc.)
- Rules — Browse routing rules with type filtering
- Connections — View active connections, kill individual or all
# Install Go 1.21+
snap install go --classic
# Build
git clone <repo> && cd clash-tui
go build -o clash-tui .
# Quick start (defaults to 127.0.0.1:9090, no secret)
./clash-tui
# Custom host and secret via CLI flags
./clash-tui --host http://127.0.0.1:19090 --secret mysecret
# Or via config file (~/.config/clash-tui/config.json)
# { "host": "http://127.0.0.1:19090", "secret": "mysecret" }
| Key |
Global |
1-4 |
Switch tabs |
Tab / h l |
Next/previous tab |
q / Ctrl+C |
Quit |
| Key |
Proxies Tab |
↑ ↓ / j k |
Navigate |
Enter |
Expand group / Switch node |
d |
Test delay |
r |
Refresh |
| Key |
Config Tab |
↑ ↓ / j k |
Navigate fields |
Enter |
Edit / Toggle |
↑ ↓ |
Cycle enum options |
Esc |
Cancel edit |
| Key |
Connections Tab |
d |
Kill selected connection |
D |
Kill all connections (confirm) |
| Key |
Rules Tab |
f |
Cycle type filter |
- Re-enable and redesign Logs with proper streaming handling (avoid timeout-based polling errors).
- Re-enable and stabilize Traffic Monitor refresh behavior and UI presentation.
Ensure your mihomo config has the external controller enabled:
external-controller: 127.0.0.1:19090
secret: "your-secret"