# hkuds/cli-anything architecture

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

- Interactive diagram: https://gitdiagram.com/hkuds/cli-anything
- Repository: https://github.com/hkuds/cli-anything
- Video tour (about a minute): https://gitdiagram.com/hkuds/cli-anything/video

## Overview

CLI-Anything is an ecosystem for making software agent-accessible through generated command-line harnesses, with CLI-Hub for discovery and installation. The principal workflow is an agent or user invoking a harness to operate an underlying application and produce an artifact; preview and live-preview capabilities support artifact inspection. The tree and excerpts show selected harnesses, not the shared harness-generation implementation in full, so the graph keeps those examples distinct and limits relationships to README-documented capabilities.

Main entry points: [`cli-hub/cli_hub/installer.py`](https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/installer.py) (CLI installer), [`cli-hub/cli_hub/cli.py`](https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/cli.py) (Hub commands), [`3MF/agent-harness/cli_anything/threemf/core/parser.py`](https://github.com/hkuds/cli-anything/blob/main/3MF/agent-harness/cli_anything/threemf/core/parser.py) (3MF harness), [`QGIS/agent-harness/cli_anything/qgis/core/project.py`](https://github.com/hkuds/cli-anything/blob/main/QGIS/agent-harness/cli_anything/qgis/core/project.py) (QGIS harness)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hub["CLI-Hub"]
  node_hub_cli["Hub commands<br/>[cli.py]"]
  node_registry[("CLI registry<br/>[registry.py]")]
  node_installer["CLI installer<br/>[installer.py]"]
  node_hub_preview["Hub previews<br/>[preview.py]"]
end

subgraph group_authoring["Harness tooling"]
  node_skill["Skill generator<br/>[skill_generator.py]"]
end

subgraph group_harnesses["Application harnesses"]
  node_threemf["3MF harness<br/>[parser.py]"]
  node_qgis["QGIS harness<br/>[project.py]"]
  node_firefly["Firefly III harness<br/>[firefly_iii_cli.py]"]
  node_captioning["Video captioning<br/>[pipeline.py]"]
end

subgraph group_preview["Artifact preview"]
  node_preview_plugin["Preview bundles<br/>[preview_bundle.py]"]
end

node_user(("User or agent"))
node_software["Underlying software"]
node_artifact["Generated artifact"]

node_user -->|"browses or installs"| node_hub_cli
node_hub_cli -->|"browses"| node_registry
node_hub_cli -->|"installs"| node_installer
node_installer -->|"installs harness"| node_threemf
node_installer -->|"installs harness"| node_qgis
node_installer -->|"installs harness"| node_firefly
node_user -.->|"requests skill"| node_skill
node_user -->|"invokes"| node_threemf
node_user -->|"invokes"| node_qgis
node_user -->|"invokes"| node_firefly
node_user -->|"invokes"| node_captioning
node_threemf -.->|"operates"| node_software
node_qgis -.->|"operates"| node_software
node_firefly -.->|"operates"| node_software
node_captioning -->|"produces"| node_artifact
node_preview_plugin -->|"previews"| node_artifact
node_hub_preview -->|"previews"| node_artifact

click node_hub_cli "https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/cli.py"
click node_registry "https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/registry.py"
click node_installer "https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/installer.py"
click node_skill "https://github.com/hkuds/cli-anything/blob/main/cli-anything-plugin/skill_generator.py"
click node_preview_plugin "https://github.com/hkuds/cli-anything/blob/main/cli-anything-plugin/preview_bundle.py"
click node_hub_preview "https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/preview.py"
click node_threemf "https://github.com/hkuds/cli-anything/blob/main/3MF/agent-harness/cli_anything/threemf/core/parser.py"
click node_qgis "https://github.com/hkuds/cli-anything/blob/main/QGIS/agent-harness/cli_anything/qgis/core/project.py"
click node_firefly "https://github.com/hkuds/cli-anything/blob/main/firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.py"
click node_captioning "https://github.com/hkuds/cli-anything/blob/main/videocaptioner/agent-harness/cli_anything/videocaptioner/core/pipeline.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_hub_cli,node_registry,node_installer,node_hub_preview,node_user toneBlue
class node_skill toneAmber
class node_threemf,node_qgis,node_firefly,node_captioning toneMint
class node_preview_plugin toneRose
class node_software,node_artifact toneIndigo
```

## Components

### CLI-Hub

- [Hub commands](https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/cli.py): `cli-hub/cli_hub/cli.py`
- [CLI registry](https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/registry.py): `cli-hub/cli_hub/registry.py`
- [CLI installer](https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/installer.py): `cli-hub/cli_hub/installer.py`
- [Hub previews](https://github.com/hkuds/cli-anything/blob/main/cli-hub/cli_hub/preview.py): `cli-hub/cli_hub/preview.py`

### Harness tooling

- [Skill generator](https://github.com/hkuds/cli-anything/blob/main/cli-anything-plugin/skill_generator.py): `cli-anything-plugin/skill_generator.py`

### Application harnesses

- [3MF harness](https://github.com/hkuds/cli-anything/blob/main/3MF/agent-harness/cli_anything/threemf/core/parser.py): `3MF/agent-harness/cli_anything/threemf/core/parser.py`
- [QGIS harness](https://github.com/hkuds/cli-anything/blob/main/QGIS/agent-harness/cli_anything/qgis/core/project.py): `QGIS/agent-harness/cli_anything/qgis/core/project.py`
- [Firefly III harness](https://github.com/hkuds/cli-anything/blob/main/firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.py): `firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.py`
- [Video captioning](https://github.com/hkuds/cli-anything/blob/main/videocaptioner/agent-harness/cli_anything/videocaptioner/core/pipeline.py): `videocaptioner/agent-harness/cli_anything/videocaptioner/core/pipeline.py`

### Artifact preview

- [Preview bundles](https://github.com/hkuds/cli-anything/blob/main/cli-anything-plugin/preview_bundle.py): `cli-anything-plugin/preview_bundle.py`

### Other components

- **User or agent**
- **Underlying software**
- **Generated artifact**

## Connections

- User or agent → Hub commands: browses or installs (evidence: `README.md`)
- Hub commands → CLI registry: browses (evidence: `README.md`)
- Hub commands → CLI installer: installs (evidence: `README.md`)
- CLI installer → 3MF harness: installs harness (evidence: `README.md`)
- CLI installer → QGIS harness: installs harness (evidence: `README.md`)
- CLI installer → Firefly III harness: installs harness (evidence: `README.md`)
- User or agent → Skill generator: requests skill
- User or agent → 3MF harness: invokes (evidence: `README.md`)
- User or agent → QGIS harness: invokes (evidence: `README.md`)
- User or agent → Firefly III harness: invokes (evidence: `README.md`)
- User or agent → Video captioning: invokes (evidence: `README.md`)
- 3MF harness → Underlying software: operates
- QGIS harness → Underlying software: operates
- Firefly III harness → Underlying software: operates
- Video captioning → Generated artifact: produces (evidence: `videocaptioner/agent-harness/cli_anything/videocaptioner/core/pipeline.py`)
- Preview bundles → Generated artifact: previews (evidence: `README.md`)
- Hub previews → Generated artifact: previews (evidence: `README.md`)
