# zhelly-dev/shutapp architecture

> Architecture diagram of the GitHub repository zhelly-dev/shutapp, 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/zhelly-dev/shutapp
- Repository: https://github.com/zhelly-dev/shutapp

## Overview

ShutApp is a small command-line productivity tool: the user supplies a banlist, the program parses per-process durations, then runs a timed worker for each entry that repeatedly finds and kills matching processes. The runtime is implemented in one source file. The README describes this workflow; the GUI remains a TODO, so it is not represented as implemented.

Main entry points: [`main.go`](https://github.com/zhelly-dev/shutapp/blob/main/main.go) (CLI entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["ShutApp runtime"]
  node_command["CLI entry<br/>[main.go]"]
  node_banlist["Banlist parser<br/>[main.go]"]
  node_worker["Timed process worker<br/>[main.go]"]
end

node_user(("User"))
node_processes["Operating system processes"]

node_user -->|"runs with file"| node_command
node_command -->|"loads entries"| node_banlist
node_command -->|"starts per entry"| node_worker
node_worker -->|"scans and kills"| node_processes

click node_command "https://github.com/zhelly-dev/shutapp/blob/main/main.go"
click node_banlist "https://github.com/zhelly-dev/shutapp/blob/main/main.go"
click node_worker "https://github.com/zhelly-dev/shutapp/blob/main/main.go"

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_command,node_banlist,node_worker,node_user toneBlue
class node_processes toneIndigo
```

## Components

### ShutApp runtime

- [CLI entry](https://github.com/zhelly-dev/shutapp/blob/main/main.go): `main.go`
- [Banlist parser](https://github.com/zhelly-dev/shutapp/blob/main/main.go): `main.go`
- [Timed process worker](https://github.com/zhelly-dev/shutapp/blob/main/main.go): `main.go`

### Other components

- **User**
- **Operating system processes**

## Connections

- User → CLI entry: runs with file (evidence: `README.md`)
- CLI entry → Banlist parser: loads entries (evidence: `main.go`)
- CLI entry → Timed process worker: starts per entry (evidence: `main.go`)
- Timed process worker → Operating system processes: scans and kills (evidence: `main.go`)
