jason/socktop
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
master
socktop/socktop
History
jasonwitty 6eb1809309 set connector back to crate version
2025-11-17 14:15:39 -08:00
..
proto Publish: include proto in each crate and fix build.rs paths 2025-08-22 10:44:56 -07:00
src patch header for small monitors and increase cargo version in advance of publish. 2025-11-17 11:52:22 -08:00
tests feature - add error modal support and retry 2025-09-15 10:16:47 -07:00
Cargo.toml set connector back to crate version 2025-11-17 14:15:39 -08:00
README.md docs: add per-crate README.md and link via Cargo.toml readme field 2025-08-24 17:56:22 -07:00

README.md

socktop (client)

Minimal TUI client for the socktop remote monitoring agent.

Features:

  • Connects to a socktop_agent over WebSocket / secure WebSocket
  • Displays CPU, memory, swap, disks, network, processes, (optional) GPU metrics
  • Self‑signed TLS cert pinning via --tls-ca
  • Profile management with saved intervals
  • Low CPU usage (request-driven updates)

Quick start:

cargo install socktop
socktop ws://HOST:3000/ws

With TLS (copy agent cert first):

socktop --tls-ca cert.pem wss://HOST:8443/ws

Demo mode (spawns a local agent automatically on first run prompt):

socktop --demo

Full documentation, screenshots, and advanced usage: https://github.com/jasonwitty/socktop