# thenareshofficial/sysmom-cli architecture

> Architecture diagram of the GitHub repository thenareshofficial/sysmom-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thenareshofficial/sysmom-cli
- Repository: https://github.com/thenareshofficial/sysmom-cli

## Overview

SysMom is a terminal system-monitoring CLI. Users launch a live dashboard or request a snapshot, process list, disk, network, sensor, or export command. The CLI creates a monitor for each request; the monitor gathers system metrics, which the dashboard or exporter presents. The README documents all major metric areas and JSON/Markdown exports. The graph uses the sampled CLI and module references; detailed monitor internals are only partially excerpted, so metric collection is represented as one component.

Main entry points: [`sysmom/cli.py`](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/cli.py) (Commands and routing), [`sysmom/monitor.py`](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/monitor.py) (System monitor), [`sysmom/dashboard.py`](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/dashboard.py) (Live dashboard), [`sysmom/exporter.py`](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/exporter.py) (Snapshot formats)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_cli["Commands and routing<br/>[cli.py]"]
  node_config["Dashboard settings<br/>[config.py]"]
end

subgraph group_collection["Metrics collection"]
  node_monitor["System monitor<br/>[monitor.py]"]
end

subgraph group_presentation["Presentation and export"]
  node_dashboard["Live dashboard<br/>[dashboard.py]"]
  node_exporter["Snapshot formats<br/>[exporter.py]"]
end

node_user(("CLI user"))
node_host["Host metrics APIs"]
node_sensor_tools["Hardware sensor tools"]

node_user -->|"runs commands"| node_cli
node_cli -->|"sets options"| node_config
node_cli -->|"collects metrics"| node_monitor
node_cli -->|"launches dashboard"| node_dashboard
node_cli -->|"formats snapshots"| node_exporter
node_dashboard -->|"requests snapshots"| node_monitor
node_dashboard -->|"uses settings"| node_config
node_exporter -->|"reuses panels"| node_dashboard
node_monitor -->|"reads system metrics"| node_host
node_monitor -->|"queries sensors"| node_sensor_tools

click node_cli "https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/cli.py"
click node_config "https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/config.py"
click node_monitor "https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/monitor.py"
click node_dashboard "https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/dashboard.py"
click node_exporter "https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/exporter.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_config,node_user toneBlue
class node_monitor toneAmber
class node_dashboard,node_exporter,node_host toneMint
class node_sensor_tools toneIndigo
```

## Components

### CLI entry

- [Commands and routing](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/cli.py): `sysmom/cli.py`
- [Dashboard settings](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/config.py): `sysmom/config.py`

### Metrics collection

- [System monitor](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/monitor.py): `sysmom/monitor.py`

### Presentation and export

- [Live dashboard](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/dashboard.py): `sysmom/dashboard.py`
- [Snapshot formats](https://github.com/thenareshofficial/sysmom-cli/blob/main/sysmom/exporter.py): `sysmom/exporter.py`

### Other components

- **CLI user**
- **Host metrics APIs**
- **Hardware sensor tools**

## Connections

- CLI user → Commands and routing: runs commands (evidence: `README.md`)
- Commands and routing → Dashboard settings: sets options (evidence: `sysmom/cli.py`)
- Commands and routing → System monitor: collects metrics (evidence: `sysmom/cli.py`)
- Commands and routing → Live dashboard: launches dashboard (evidence: `sysmom/cli.py`)
- Commands and routing → Snapshot formats: formats snapshots (evidence: `sysmom/cli.py`)
- Live dashboard → System monitor: requests snapshots (evidence: `sysmom/dashboard.py`)
- Live dashboard → Dashboard settings: uses settings (evidence: `sysmom/dashboard.py`)
- Snapshot formats → Live dashboard: reuses panels (evidence: `sysmom/exporter.py`)
- System monitor → Host metrics APIs: reads system metrics (evidence: `sysmom/monitor.py`)
- System monitor → Hardware sensor tools: queries sensors (evidence: `sysmom/monitor.py`)
