# gmhabchi/gmh-cli architecture

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

- Interactive diagram: https://gitdiagram.com/gmhabchi/gmh-cli
- Repository: https://github.com/gmhabchi/gmh-cli

## Overview

GMH-CLI is a shell-sourced collection of personal workflow commands. The documented entry point exposes command functions and selects shell-specific completion; users then invoke commands for setup, cloud/container operations, environment management, and utilities. The README identifies these capabilities and their files, but no source excerpts were provided, so internal calls and command-to-service interactions cannot be verified and are omitted.

Main entry points: [`main.sh`](https://github.com/gmhabchi/gmh-cli/blob/master/main.sh) (Shell entry point), [`src/completion.bash`](https://github.com/gmhabchi/gmh-cli/blob/master/src/completion.bash) (Bash completion), [`src/completion.zsh`](https://github.com/gmhabchi/gmh-cli/blob/master/src/completion.zsh) (Zsh completion), [`src/functions.sh`](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh) (Command functions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Shell entry"]
  node_main["Shell entry point<br/>[main.sh]"]
end

subgraph group_commands["Command capabilities"]
  node_commands["Command functions<br/>[functions.sh]"]
  node_help["Help system<br/>[help.sh]"]
  node_shared["Shared configuration<br/>[shared.sh]"]
  node_helpers["Helper functions<br/>[helper.sh]"]
  node_aliases["Shell aliases<br/>[alias.sh]"]
  node_setup["Dependency setup<br/>[functions.sh]"]
  node_aws["AWS workflows<br/>[functions.sh]"]
  node_kubernetes["Kubernetes workflows<br/>[functions.sh]"]
  node_pulumi["Pulumi workflows<br/>[functions.sh]"]
  node_docker["Docker workflows<br/>[functions.sh]"]
  node_utilities["Utility commands<br/>[functions.sh]"]
end

subgraph group_completion["Shell completion"]
  node_bash_completion["Bash completion<br/>[completion.bash]"]
  node_zsh_completion["Zsh completion<br/>[completion.zsh]"]
end

node_user(("Shell user"))
node_bash(("Bash shell"))
node_zsh(("Zsh shell"))

node_user -->|"sources"| node_main
node_main -->|"exposes"| node_commands
node_main -->|"loads for Bash"| node_bash_completion
node_main -->|"loads for Zsh"| node_zsh_completion
node_bash -->|"completes commands"| node_bash_completion
node_zsh -->|"completes commands"| node_zsh_completion

click node_main "https://github.com/gmhabchi/gmh-cli/blob/master/main.sh"
click node_commands "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_help "https://github.com/gmhabchi/gmh-cli/blob/master/src/help.sh"
click node_shared "https://github.com/gmhabchi/gmh-cli/blob/master/src/shared.sh"
click node_helpers "https://github.com/gmhabchi/gmh-cli/blob/master/src/helper.sh"
click node_aliases "https://github.com/gmhabchi/gmh-cli/blob/master/src/alias.sh"
click node_setup "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_aws "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_kubernetes "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_pulumi "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_docker "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_utilities "https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh"
click node_bash_completion "https://github.com/gmhabchi/gmh-cli/blob/master/src/completion.bash"
click node_zsh_completion "https://github.com/gmhabchi/gmh-cli/blob/master/src/completion.zsh"

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_main,node_user toneBlue
class node_commands,node_help,node_shared,node_helpers,node_aliases,node_setup,node_aws,node_kubernetes,node_pulumi,node_docker,node_utilities toneAmber
class node_bash_completion,node_zsh_completion toneMint
class node_bash,node_zsh toneIndigo
```

## Components

### Shell entry

- [Shell entry point](https://github.com/gmhabchi/gmh-cli/blob/master/main.sh): `main.sh`

### Command capabilities

- [Command functions](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`
- [Help system](https://github.com/gmhabchi/gmh-cli/blob/master/src/help.sh): `src/help.sh`
- [Shared configuration](https://github.com/gmhabchi/gmh-cli/blob/master/src/shared.sh): `src/shared.sh`
- [Helper functions](https://github.com/gmhabchi/gmh-cli/blob/master/src/helper.sh): `src/helper.sh`
- [Shell aliases](https://github.com/gmhabchi/gmh-cli/blob/master/src/alias.sh): `src/alias.sh`
- [Dependency setup](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`
- [AWS workflows](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`
- [Kubernetes workflows](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`
- [Pulumi workflows](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`
- [Docker workflows](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`
- [Utility commands](https://github.com/gmhabchi/gmh-cli/blob/master/src/functions.sh): `src/functions.sh`

### Shell completion

- [Bash completion](https://github.com/gmhabchi/gmh-cli/blob/master/src/completion.bash): `src/completion.bash`
- [Zsh completion](https://github.com/gmhabchi/gmh-cli/blob/master/src/completion.zsh): `src/completion.zsh`

### Other components

- **Shell user**
- **Bash shell**
- **Zsh shell**

## Connections

- Shell user → Shell entry point: sources (evidence: `README.md`)
- Shell entry point → Command functions: exposes (evidence: `README.md`)
- Shell entry point → Bash completion: loads for Bash (evidence: `README.md`)
- Shell entry point → Zsh completion: loads for Zsh (evidence: `README.md`)
- Bash shell → Bash completion: completes commands (evidence: `README.md`)
- Zsh shell → Zsh completion: completes commands (evidence: `README.md`)
