Watch

mirror of https://github.com/jasonwitty/socktop synced 2026-09-06 04:56:14 +00:00

No description

Rust 94.8%
Shell 3.1%
HTML 2.1%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
jasonwitty f17b60f269 Enhance README with badges and images Added badges for crates.io version, total downloads, GitHub stars, and license to README.		2026-08-31 01:25:24 -07:00
.githooks	chore: make pre-commit resilient when cargo absent	2025-08-26 00:18:10 -07:00
.github/workflows	fix(ci): pin deb builds to ubuntu-22.04 and enforce the fleet glibc floor (#41 )	2026-08-23 09:42:39 -07:00
apt-repo	Add Debian packaging support for socktop-agent (#25 )	2026-06-02 13:12:51 -07:00
docs	Update socktop preview image to version 1.60	2026-08-23 20:47:41 -07:00
proto	protobuff Process list	2025-08-19 23:24:36 -07:00
scripts	housekeeping-p2: security, correctness, and performance pass before 1.51 (#39 )	2026-08-21 12:45:10 -07:00
socktop	Reject unknown options in parse_args instead of treating them as the URL	2026-08-24 09:46:20 -07:00
socktop_agent	minor bump to cargo version	2026-08-24 07:22:51 -07:00
socktop_connector	minor bump to cargo version	2026-08-24 07:22:51 -07:00
socktop_wasm_test	housekeeping-p2: security, correctness, and performance pass before 1.51 (#39 )	2026-08-21 12:45:10 -07:00
zellij_socktop_plugin	housekeeping-p2: security, correctness, and performance pass before 1.51 (#39 )	2026-08-21 12:45:10 -07:00
.gitignore	housekeeping-p2: security, correctness, and performance pass before 1.51 (#39 )	2026-08-21 12:45:10 -07:00
Cargo.lock	fix formatting	2026-08-24 07:26:16 -07:00
Cargo.toml	fix(ui): keep the important text visible on narrow terminals (#38 )	2026-08-18 22:47:03 -07:00
CHANGELOG.md	Add flag to override logic and supress terminate option. (--no-kill)	2026-08-24 07:19:37 -07:00
DEBIAN_PACKAGING_SUMMARY.md	Add Debian packaging support for socktop-agent (#25 )	2026-06-02 13:12:51 -07:00
LICENSE	Update copyright year in LICENSE file	2026-08-23 18:33:08 -07:00
README.md	Enhance README with badges and images	2026-08-31 01:25:24 -07:00
rust-toolchain.toml	patch for macbook compatibility issues.	2025-08-15 19:21:34 -07:00

README.md

socktop

socktop is a remote system monitor with a rich TUI, talking to an ultra lightweight agent over WebSockets.

Resources

Resource	Location
Website and online demo (yes it's real)	socktop.io
Quick Start guide	https://socktop.io/assets/docs/installation/quick-start.html
Prereqs	https://socktop.io/assets/docs/installation/prerequisites.html
APT Install	https://socktop.io/assets/docs/installation/apt.html
Cargo Install	https://socktop.io/assets/docs/installation/cargo.html
Usage	https://socktop.io/assets/docs/usage/general.html
Auth Setup	https://socktop.io/assets/docs/security/token.html
TLS Setup	https://socktop.io/assets/docs/security/tls.html
Monitoring Multiple Hosts	tmux / zellij

Platform Support

Linux (all flavors), ARM/Raspberry Pi (32b/64b), MacOS, Windows, RISC-V (experimental)

Contributing

Contributions are welcome and you have the freedom to use whatever development tools you would like, as long as there is a human in the loop and all the clippy and unit tests pass you are good to submit a PR. Defects / Bugs just go ahead and fix and file a PR. New features, please create a issue in advance and let me know you are offering to build it. I don't want to be in a position where you worked for a couple of weeks on something and I don't want to merge it.

Development

cargo fmt
cargo clippy --all-targets --all-features
cargo run -p socktop -- ws://127.0.0.1:3000/ws
# TLS (dev): first run will create certs under ~/.config/socktop_agent/tls/
cargo run -p socktop_agent -- --enableSSL --port 8443

Auto-format on commit

A sample pre-commit hook that runs cargo fmt --all is provided in .githooks/pre-commit. Enable it (one-time):

License

MIT — see LICENSE.

Acknowledgements

ratatui for the TUI
sysinfo for system metrics
tokio-tungstenite for WebSockets