# skpaul82/axle-cli architecture

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

- Interactive diagram: https://gitdiagram.com/skpaul82/axle-cli
- Repository: https://github.com/skpaul82/axle-cli

## Overview

Axle is a modular CLI for discovering and running Python microtools from a shared tools directory. The principal workflow is a user selecting a tool interactively or by name/number, supplying arguments, and receiving that tool’s output; discovery supports different tool styles and help. Optional pre-run security validation and code review, persistent settings, and tool metadata are separate capabilities. The repository also ships SEO and content-analysis tools. Edges are limited to relationships shown in the README or source index; unsampled implementation details are not inferred.

Main entry points: [`axle/tool_discoverer.py`](https://github.com/skpaul82/axle-cli/blob/main/axle/tool_discoverer.py) (Tool discovery), [`axle/axle.py`](https://github.com/skpaul82/axle-cli/blob/main/axle/axle.py) (Axle commands), [`axle/interactive.py`](https://github.com/skpaul82/axle-cli/blob/main/axle/interactive.py) (Interactive picker), [`axle/config.py`](https://github.com/skpaul82/axle-cli/blob/main/axle/config.py) (CLI settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI experience"]
  node_cli["Axle commands<br/>[axle.py]"]
  node_interactive["Interactive picker<br/>[interactive.py]"]
end

subgraph group_runtime["Tool runtime"]
  node_discovery["Tool discovery<br/>[tool_discoverer.py]"]
end

subgraph group_governance["Validation and settings"]
  node_settings[("CLI settings<br/>[config.py]")]
  node_validator["Security validation<br/>[tool_validator.py]"]
  node_securityscan["Dependency scan<br/>[security_scan.py]"]
  node_reviewer["Code review<br/>[code_reviewer.py]"]
end

subgraph group_catalog["Tool catalog"]
  node_metadata[("Tool metadata<br/>[tool_metadata.py]")]
end

subgraph group_tools["Built-in tools"]
  node_seo["SEO keyword checker"]
  node_metaaudit["Meta tag auditor"]
  node_lifehacks["Life hack generator"]
  node_competitor["Competitor analysis"]
  node_brief["Content brief generator"]
  node_benchmark["Content benchmarker"]
  node_optimizer["Content optimizer"]
  node_toolset["Other Python tools"]
end

node_user(("CLI user"))

node_user -->|"runs commands"| node_cli
node_cli -->|"offers picker"| node_interactive
node_interactive -->|"selects tools"| node_discovery
node_cli -->|"dispatches tools"| node_discovery
node_discovery -.->|"runs discovered tool"| node_seo
node_discovery -.->|"runs discovered tool"| node_metaaudit
node_discovery -.->|"runs discovered tool"| node_lifehacks
node_discovery -.->|"runs discovered tool"| node_competitor
node_discovery -.->|"runs discovered tool"| node_brief
node_discovery -.->|"runs discovered tool"| node_benchmark
node_discovery -.->|"runs discovered tool"| node_optimizer
node_discovery -->|"discovers scripts"| node_toolset
node_cli -->|"validates optionally"| node_validator
node_cli -->|"reviews optionally"| node_reviewer
node_cli -->|"configures features"| node_settings
node_cli -->|"offers scan command"| node_securityscan
node_cli -->|"offers metadata commands"| node_metadata

click node_cli "https://github.com/skpaul82/axle-cli/blob/main/axle/axle.py"
click node_interactive "https://github.com/skpaul82/axle-cli/blob/main/axle/interactive.py"
click node_discovery "https://github.com/skpaul82/axle-cli/blob/main/axle/tool_discoverer.py"
click node_settings "https://github.com/skpaul82/axle-cli/blob/main/axle/config.py"
click node_validator "https://github.com/skpaul82/axle-cli/blob/main/axle/tool_validator.py"
click node_securityscan "https://github.com/skpaul82/axle-cli/blob/main/axle/security_scan.py"
click node_reviewer "https://github.com/skpaul82/axle-cli/blob/main/axle/code_reviewer.py"
click node_metadata "https://github.com/skpaul82/axle-cli/blob/main/axle/tool_metadata.py"
click node_seo "https://github.com/skpaul82/axle-cli/blob/main/tools/01_seo_keyword_checker.py"
click node_metaaudit "https://github.com/skpaul82/axle-cli/blob/main/tools/02_meta_tag_auditor.py"
click node_lifehacks "https://github.com/skpaul82/axle-cli/blob/main/tools/03_daily_life_hack_generator.py"
click node_competitor "https://github.com/skpaul82/axle-cli/blob/main/tools/competitor_analysis.py"
click node_brief "https://github.com/skpaul82/axle-cli/blob/main/tools/content_brief_generator.py"
click node_benchmark "https://github.com/skpaul82/axle-cli/blob/main/tools/content_length_benchmarker.py"
click node_optimizer "https://github.com/skpaul82/axle-cli/blob/main/tools/content_optimizer.py"
click node_toolset "https://github.com/skpaul82/axle-cli/tree/main/tools"

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_interactive,node_user toneBlue
class node_discovery toneAmber
class node_settings,node_validator,node_securityscan,node_reviewer toneMint
class node_metadata toneRose
class node_seo,node_metaaudit,node_lifehacks,node_competitor,node_brief,node_benchmark,node_optimizer,node_toolset toneIndigo
```

## Components

### CLI experience

- [Axle commands](https://github.com/skpaul82/axle-cli/blob/main/axle/axle.py): `axle/axle.py`
- [Interactive picker](https://github.com/skpaul82/axle-cli/blob/main/axle/interactive.py): `axle/interactive.py`

### Tool runtime

- [Tool discovery](https://github.com/skpaul82/axle-cli/blob/main/axle/tool_discoverer.py): `axle/tool_discoverer.py`

### Validation and settings

- [CLI settings](https://github.com/skpaul82/axle-cli/blob/main/axle/config.py): `axle/config.py`
- [Security validation](https://github.com/skpaul82/axle-cli/blob/main/axle/tool_validator.py): `axle/tool_validator.py`
- [Dependency scan](https://github.com/skpaul82/axle-cli/blob/main/axle/security_scan.py): `axle/security_scan.py`
- [Code review](https://github.com/skpaul82/axle-cli/blob/main/axle/code_reviewer.py): `axle/code_reviewer.py`

### Tool catalog

- [Tool metadata](https://github.com/skpaul82/axle-cli/blob/main/axle/tool_metadata.py): `axle/tool_metadata.py`

### Built-in tools

- [SEO keyword checker](https://github.com/skpaul82/axle-cli/blob/main/tools/01_seo_keyword_checker.py): `tools/01_seo_keyword_checker.py`
- [Meta tag auditor](https://github.com/skpaul82/axle-cli/blob/main/tools/02_meta_tag_auditor.py): `tools/02_meta_tag_auditor.py`
- [Life hack generator](https://github.com/skpaul82/axle-cli/blob/main/tools/03_daily_life_hack_generator.py): `tools/03_daily_life_hack_generator.py`
- [Competitor analysis](https://github.com/skpaul82/axle-cli/blob/main/tools/competitor_analysis.py): `tools/competitor_analysis.py`
- [Content brief generator](https://github.com/skpaul82/axle-cli/blob/main/tools/content_brief_generator.py): `tools/content_brief_generator.py`
- [Content benchmarker](https://github.com/skpaul82/axle-cli/blob/main/tools/content_length_benchmarker.py): `tools/content_length_benchmarker.py`
- [Content optimizer](https://github.com/skpaul82/axle-cli/blob/main/tools/content_optimizer.py): `tools/content_optimizer.py`
- [Other Python tools](https://github.com/skpaul82/axle-cli/tree/main/tools): `tools`

### Other components

- **CLI user**

## Connections

- CLI user → Axle commands: runs commands (evidence: `README.md`)
- Axle commands → Interactive picker: offers picker (evidence: `README.md`)
- Interactive picker → Tool discovery: selects tools (evidence: `axle/interactive.py`)
- Axle commands → Tool discovery: dispatches tools (evidence: `axle/axle.py`)
- Tool discovery → SEO keyword checker: runs discovered tool
- Tool discovery → Meta tag auditor: runs discovered tool
- Tool discovery → Life hack generator: runs discovered tool
- Tool discovery → Competitor analysis: runs discovered tool
- Tool discovery → Content brief generator: runs discovered tool
- Tool discovery → Content benchmarker: runs discovered tool
- Tool discovery → Content optimizer: runs discovered tool
- Tool discovery → Other Python tools: discovers scripts (evidence: `README.md`)
- Axle commands → Security validation: validates optionally (evidence: `README.md`)
- Axle commands → Code review: reviews optionally (evidence: `README.md`)
- Axle commands → CLI settings: configures features (evidence: `axle/axle.py`)
- Axle commands → Dependency scan: offers scan command (evidence: `README.md`)
- Axle commands → Tool metadata: offers metadata commands (evidence: `axle/axle.py`)
