SOT(1)

NAME
sot - sot is a Command-line System Observation Tool in the spirit of top. It displays various interesting system stats and graphs them. Works on all operating systems.

SYNOPSIS
sot [--help] [--version] [--log LOG] [--net NET] [--disk [DISK]] {info,bench,disk,clean,ps} ...

DESCRIPTION
Command-line System Observation Tool ≈

POSITIONAL ARGUMENTS

sot info
    Display system information

sot bench
    Disk benchmarking

sot disk
    Interactive disk information viewer

sot clean
    Deep clean system caches, logs, and temp files

sot ps
    Interactive process viewer

COMMAND 'sot info'
usage: sot info [-h]

COMMAND 'sot bench'
usage: sot bench [-h] [--output OUTPUT] [--duration DURATION]

OPTIONS 'sot bench'

--output OUTPUT, -o OUTPUT
    Output file for benchmark results (JSON format)

--duration DURATION, -d DURATION
    Duration for each benchmark test in seconds (default: 10s)

COMMAND 'sot disk'
usage: sot disk [-h]

COMMAND 'sot clean'
usage: sot clean [-h] [--dry-run]

OPTIONS 'sot clean'

--dry-run
    Show what would be cleaned without actually deleting

COMMAND 'sot ps'
usage: sot ps [-h]

OPTIONS

--version, -V
    Display version information with styling

--log LOG, -L LOG
    Debug log file path (enables debug logging)

--net NET, -N NET
    Network interface to display (default: auto-detect best interface)

--disk [DISK], -D [DISK]
    Disk mountpoint to display (use without value for interactive selection)

EXAMPLES

sot Launch the interactive system monitoring TUI

sot --net eth0
    Monitor system with specific network interface

sot --disk
    Interactive disk mountpoint selection

sot --disk /
    Monitor system with root disk

sot info
    Display comprehensive system information

sot bench
    Run interactive disk benchmark

sot bench --duration 30 --output results.json
    Run 30-second benchmarks and save results to JSON

sot disk
    View interactive disk information

sot clean --dry-run
    Preview what would be cleaned without deleting

sot clean
    Deep clean system caches and temp files

sot ps
    Launch interactive process viewer with ports and dev environments

FEATURES

  System Monitoring

•   CPU usage per core and thread

•   Process management with interactive sorting

•   Memory usage and capacity monitoring

•   Network upload/download speed and bandwidth

•   Disk I/O statistics and usage

  System Information (sot info)

•   Hardware details (chip, GPU, memory)

•   Software information (OS, kernel, shell)

•   Display configuration and brightness

•   Battery status and system uptime

•   OS-specific ASCII logos

  Disk Benchmarking (sot bench)

•   Sequential read/write throughput

•   Random read/write IOPS

•   Latency percentiles (p50, p95, p99)

•   JSON export for results

  System Cleaning (sot clean)

•   Clean system caches (user, system, font caches)

•   Remove temporary files

•   Clear application logs and crash reports

•   Dry-run mode to preview changes

•   macOS-specific cleaning (Xcode, Homebrew, etc.)

  Process Viewer (sot ps)

•   Interactive process list with sorting

•   Port monitoring with process association

•   Development environment detection

•   Kill/terminate processes interactively

•   Multi-panel interface with tab navigation

INTERACTIVE CONTROLS

  Main Interface

q   Quit the application

O   Enter order-by mode for process sorting

Arrow keys
    Navigate columns in order-by mode

Enter
    Toggle sort direction (DESC ↓ → ASC ↑ → OFF)

  Process Viewer (sot ps)

Tab Switch between panels (processes, ports, dev environments)

↑/↓ Navigate list items

Enter
    Show detailed information

K   Kill selected process (requires confirmation)

T   Terminate selected process gracefully

O   Change sort column (cycles through available columns)

S   Toggle sort direction (ascending/descending)

R   Refresh panel data

q   Quit the application

CONFIGURATION
sot does not require configuration files. All options are provided via command-line arguments.

EXIT STATUS

0   Success

1   General error (insufficient permissions, invalid arguments, etc.)

SEE ALSO
top(1), htop(1), btop(1), iostat(1), vmstat(8)

BUGS
Report bugs at: https://github.com/anistark/sot/issues

COPYRIGHT
MIT License © 2024-2026 Kumar Anirudha

AUTHOR
Written by Kumar Anirudha.

AVAILABILITY
The latest version is available at: https://github.com/anistark/sot