Files
socktop/socktop
jasonwitty d653cbcadc feat: journal access notice, 1.60.0, install script, changelog, riscv protoc fallback
- Journal pane now distinguishes 'no entries' from 'no journal access':
  journalctl exits 0 with empty output when the agent's user simply can't
  see the target's entries (demo mode / user-run agents), explaining
  itself only on stderr. The agent forwards that hint as an additive
  JournalResponse.notice and the client renders it with practical advice.
  Verified E2E via a stub journalctl emulating the unprivileged case.
- Version 1.60.0 across all crates (1.51 would read fine, but the repo's
  scheme is 1.40/1.50/…, and a literal 1.6.0 would sort BELOW 1.50.0 in
  semver). All user-facing version strings already come from
  CARGO_PKG_VERSION — a stale binary was the only way to see an old one.
- scripts/install.sh: build-from-source install/upgrade for the test
  fleet (Linux + macOS). Detects in-repo checkouts, installs rustup when
  missing, replaces a systemd socktop-agent service binary in place and
  restarts it, requires system protoc on riscv64.
- build.rs (agent + connector): fall back to $PROTOC / PATH when
  protoc-bin-vendored has no binary for the host (riscv64) — native SBC
  builds previously panicked in the build script.
- CHANGELOG.md covering v1.50.0 -> 1.60.0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-19 20:24:56 -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