socktop/socktop
jasonwitty e51054811c Refactor for additional socktop connector library
- socktop connector allows you to communicate with socktop agent directly from you code without needing to implement the agent API directly.
- will also be used for non tui implementation of "socktop collector" in the future.
- moved to rust 2024 to take advantage of some new features that helped with refactor.
- fixed everything that exploded with update.
- added rust docs for lib.
2025-09-04 05:30:25 -07:00
..
proto Publish: include proto in each crate and fix build.rs paths 2025-08-22 10:44:56 -07:00
src Refactor for additional socktop connector library 2025-09-04 05:30:25 -07:00
tests Refactor for additional socktop connector library 2025-09-04 05:30:25 -07:00
Cargo.toml Refactor for additional socktop connector library 2025-09-04 05:30:25 -07:00
README.md docs: add per-crate README.md and link via Cargo.toml readme field 2025-08-24 17:56:22 -07:00

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
  • Selfsigned 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