# azure/azure-cli architecture

> Architecture diagram of the GitHub repository azure/azure-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/azure/azure-cli
- Repository: https://github.com/azure/azure-cli

## Overview

Azure CLI is a command-line client for managing Azure resources. The main user workflow is to invoke `az` with a command and arguments, parse and dispatch the request to a command module, make Azure API calls, and present a result. The core also provides authentication, cloud-aware SDK clients, output and help support, extensions, and telemetry. The README documents capabilities such as completion, query expressions, output formats, and REST commands; their detailed runtime wiring is not fully shown in the sampled source, so some relationships remain unverified.

Main entry points: [`src/azure-cli/azure/cli/command_modules`](https://github.com/azure/azure-cli/tree/dev/src/azure-cli/azure/cli/command_modules) (Command modules), [`src/azure-cli-core/azure/cli/core/commands/client_factory.py`](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/commands/client_factory.py) (SDK client factory), [`src/azure-cli-core/azure/cli/core/parser.py`](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/parser.py) (Argument parser), [`src/azure-cli-core/azure/cli/core/aaz/_client.py`](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/aaz/_client.py) (AAZ HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI interaction"]
  node_entrypoint["CLI entry<br/>[__main__.py]"]
  node_parser["Argument parser<br/>[parser.py]"]
end

subgraph group_core["CLI core"]
  node_aaz_commands["Atomic commands<br/>[_base.py]"]
  node_aaz_client["AAZ HTTP client<br/>[_client.py]"]
  node_client_factory["SDK client factory<br/>[client_factory.py]"]
  node_profile["Subscription profile<br/>[_profile.py]"]
  node_session["HTTP session<br/>[_session.py]"]
  node_cloud["Cloud endpoints<br/>[cloud.py]"]
  node_policies["SDK policies<br/>[policies.py]"]
  node_output["Output and query<br/>[_output.py]"]
  node_help["Help and completion<br/>[_help.py]"]
  node_extensions["Extensions<br/>[__init__.py]"]
end

subgraph group_domains["Azure commands"]
  node_command_modules["Command modules"]
  node_resource["Resource commands<br/>[custom.py]"]
  node_template_pack["Template packing<br/>[_packing_engine.py]"]
  node_storage["Storage operations<br/>[logging.py]"]
  node_app_deploy["App deployment"]
  node_container_apps["Container Apps<br/>[_clients.py]"]
end

subgraph group_support["Shared services"]
  node_telemetry["Telemetry<br/>[telemetry.py]"]
  node_telemetry_client["Telemetry client<br/>[__init__.py]"]
  node_errors["CLI errors<br/>[azclierror.py]"]
end

node_user(("CLI user"))
node_azure{{"Azure services"}}

node_user -->|"runs commands"| node_entrypoint
node_entrypoint -.->|"parses input"| node_parser
node_parser -.->|"dispatches commands"| node_command_modules
node_parser -->|"loads extensions"| node_extensions
node_parser -->|"reports errors"| node_telemetry
node_command_modules -.->|"includes"| node_resource
node_resource -->|"packages templates"| node_template_pack
node_command_modules -.->|"includes"| node_storage
node_command_modules -.->|"includes"| node_app_deploy
node_command_modules -.->|"includes"| node_container_apps
node_command_modules -.->|"uses command layer"| node_aaz_commands
node_aaz_commands -.->|"issues operations"| node_aaz_client
node_client_factory -->|"gets subscription"| node_profile
node_client_factory -->|"configures policies"| node_policies
node_client_factory -->|"resolves extensions"| node_extensions
node_client_factory -.->|"creates service clients"| node_azure
node_aaz_client -->|"reads endpoints"| node_cloud
node_aaz_client -->|"configures policies"| node_policies
node_aaz_client -.->|"sends API requests"| node_azure
node_session -.->|"sends HTTP requests"| node_azure
node_output -.->|"formats results"| node_user
node_help -.->|"supports help"| node_user
node_telemetry -->|"uses telemetry package"| node_telemetry_client
node_errors -->|"records failures"| node_telemetry
node_resource -.->|"manages resources"| node_azure
node_storage -.->|"manages storage"| node_azure
node_app_deploy -.->|"deploys apps"| node_azure
node_container_apps -.->|"manages containers"| node_azure

click node_entrypoint "https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/__main__.py"
click node_parser "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/parser.py"
click node_command_modules "https://github.com/azure/azure-cli/tree/dev/src/azure-cli/azure/cli/command_modules"
click node_resource "https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/resource/custom.py"
click node_template_pack "https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py"
click node_storage "https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/operations/logging.py"
click node_app_deploy "https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py"
click node_container_apps "https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/containerapp/_clients.py"
click node_aaz_commands "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/aaz/_base.py"
click node_aaz_client "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/aaz/_client.py"
click node_client_factory "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/commands/client_factory.py"
click node_profile "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_profile.py"
click node_session "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_session.py"
click node_cloud "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/cloud.py"
click node_policies "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/sdk/policies.py"
click node_output "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_output.py"
click node_help "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_help.py"
click node_extensions "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/extension/__init__.py"
click node_telemetry "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/telemetry.py"
click node_telemetry_client "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-telemetry/azure/cli/telemetry/__init__.py"
click node_errors "https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/azclierror.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_entrypoint,node_parser,node_user toneBlue
class node_aaz_commands,node_aaz_client,node_client_factory,node_profile,node_session,node_cloud,node_policies,node_output,node_help,node_extensions toneAmber
class node_command_modules,node_resource,node_template_pack,node_storage,node_app_deploy,node_container_apps toneMint
class node_telemetry,node_telemetry_client,node_errors toneRose
class node_azure toneIndigo
```

## Components

### CLI interaction

- [CLI entry](https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/__main__.py): `src/azure-cli/azure/cli/__main__.py`
- [Argument parser](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/parser.py): `src/azure-cli-core/azure/cli/core/parser.py`

### CLI core

- [Atomic commands](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/aaz/_base.py): `src/azure-cli-core/azure/cli/core/aaz/_base.py`
- [AAZ HTTP client](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/aaz/_client.py): `src/azure-cli-core/azure/cli/core/aaz/_client.py`
- [SDK client factory](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/commands/client_factory.py): `src/azure-cli-core/azure/cli/core/commands/client_factory.py`
- [Subscription profile](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_profile.py): `src/azure-cli-core/azure/cli/core/_profile.py`
- [HTTP session](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_session.py): `src/azure-cli-core/azure/cli/core/_session.py`
- [Cloud endpoints](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/cloud.py): `src/azure-cli-core/azure/cli/core/cloud.py`
- [SDK policies](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/sdk/policies.py): `src/azure-cli-core/azure/cli/core/sdk/policies.py`
- [Output and query](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_output.py): `src/azure-cli-core/azure/cli/core/_output.py`
- [Help and completion](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/_help.py): `src/azure-cli-core/azure/cli/core/_help.py`
- [Extensions](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/extension/__init__.py): `src/azure-cli-core/azure/cli/core/extension/__init__.py`

### Azure commands

- [Command modules](https://github.com/azure/azure-cli/tree/dev/src/azure-cli/azure/cli/command_modules): `src/azure-cli/azure/cli/command_modules`
- [Resource commands](https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/resource/custom.py): `src/azure-cli/azure/cli/command_modules/resource/custom.py`
- [Template packing](https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py): `src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py`
- [Storage operations](https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/operations/logging.py): `src/azure-cli/azure/cli/command_modules/storage/operations/logging.py`
- [App deployment](https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py): `src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py`
- [Container Apps](https://github.com/azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/containerapp/_clients.py): `src/azure-cli/azure/cli/command_modules/containerapp/_clients.py`

### Shared services

- [Telemetry](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/telemetry.py): `src/azure-cli-core/azure/cli/core/telemetry.py`
- [Telemetry client](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-telemetry/azure/cli/telemetry/__init__.py): `src/azure-cli-telemetry/azure/cli/telemetry/__init__.py`
- [CLI errors](https://github.com/azure/azure-cli/blob/dev/src/azure-cli-core/azure/cli/core/azclierror.py): `src/azure-cli-core/azure/cli/core/azclierror.py`

### Other components

- **CLI user**
- **Azure services**

## Connections

- CLI user → CLI entry: runs commands
- CLI entry → Argument parser: parses input
- Argument parser → Command modules: dispatches commands
- Argument parser → Extensions: loads extensions (evidence: `src/azure-cli-core/azure/cli/core/parser.py`)
- Argument parser → Telemetry: reports errors (evidence: `src/azure-cli-core/azure/cli/core/parser.py`)
- Command modules → Resource commands: includes (evidence: `src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py`)
- Resource commands → Template packing: packages templates (evidence: `src/azure-cli/azure/cli/command_modules/resource/_packing_engine.py`)
- Command modules → Storage operations: includes
- Command modules → App deployment: includes (evidence: `src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py`)
- Command modules → Container Apps: includes (evidence: `src/azure-cli/azure/cli/command_modules/containerapp/_clients.py`)
- Command modules → Atomic commands: uses command layer
- Atomic commands → AAZ HTTP client: issues operations
- SDK client factory → Subscription profile: gets subscription (evidence: `src/azure-cli-core/azure/cli/core/commands/client_factory.py`)
- SDK client factory → SDK policies: configures policies (evidence: `src/azure-cli-core/azure/cli/core/commands/client_factory.py`)
- SDK client factory → Extensions: resolves extensions (evidence: `src/azure-cli-core/azure/cli/core/commands/client_factory.py`)
- SDK client factory → Azure services: creates service clients
- AAZ HTTP client → Cloud endpoints: reads endpoints (evidence: `src/azure-cli-core/azure/cli/core/aaz/_client.py`)
- AAZ HTTP client → SDK policies: configures policies (evidence: `src/azure-cli-core/azure/cli/core/aaz/_client.py`)
- AAZ HTTP client → Azure services: sends API requests
- HTTP session → Azure services: sends HTTP requests
- Output and query → CLI user: formats results
- Help and completion → CLI user: supports help
- Telemetry → Telemetry client: uses telemetry package (evidence: `src/azure-cli-core/azure/cli/core/util.py`)
- CLI errors → Telemetry: records failures (evidence: `src/azure-cli-core/azure/cli/core/azclierror.py`)
- Resource commands → Azure services: manages resources
- Storage operations → Azure services: manages storage
- App deployment → Azure services: deploys apps
- Container Apps → Azure services: manages containers
