jason/socktop
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
350611b3b1
socktop/socktop
History
jasonwitty 350611b3b1 Add Debian packaging support with cargo-deb 
- Add cargo-deb metadata to socktop and socktop_agent Cargo.toml
- Create systemd service file for socktop_agent
- Add postinst/postrm maintainer scripts for user/group management
- Create GitHub Actions workflow to build .deb packages for AMD64 and ARM64
- Add comprehensive documentation in docs/DEBIAN_PACKAGING.md
- Packages will be available as artifacts on every push
- Automatic GitHub releases for version tags
2025-11-20 23:39:26 -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 Add Debian packaging support with cargo-deb 2025-11-20 23:39:26 -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