# littledivy/mimic architecture

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

- Interactive diagram: https://gitdiagram.com/littledivy/mimic
- Repository: https://github.com/littledivy/mimic

## Overview

mimic captures an app’s traffic through mitmproxy or imports a HAR, discovers hosts and endpoints, then uses an AI generator to produce an editable Python client. That client runs on mimic.App/Session, which reuses captured credentials and makes HTTP calls; callers can also construct sessions from cURL or explicit settings. A separate unpin workflow prepares Frida-based certificate-pinning bypasses so capture can work for pinned iOS apps. The main source excerpts show the CLI, capture adapters, extraction, generation and replay calls; unsampled details are not inferred.

Main entry points: [`mimic/cli.py`](https://github.com/littledivy/mimic/blob/main/mimic/cli.py) (Mimic CLI), [`mimic/session.py`](https://github.com/littledivy/mimic/blob/main/mimic/session.py) (Session HTTP runtime), [`mimic/sources/mitm.py`](https://github.com/littledivy/mimic/blob/main/mimic/sources/mitm.py) (Mitm flow client), [`mimic/unpin.py`](https://github.com/littledivy/mimic/blob/main/mimic/unpin.py) (Unpin orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and import"]
  node_mitm["Mitm flow client<br/>[mitm.py]"]
  node_har["HAR importer<br/>[har.py]"]
  node_extract["Auth extraction<br/>[extract.py]"]
end

subgraph group_discovery["Endpoint discovery and generation"]
  node_cli["Mimic CLI<br/>[cli.py]"]
  node_discovery["Host and endpoint discovery<br/>[mitm.py]"]
  node_prompt["Prompt and endpoint digest<br/>[codegen.py]"]
end

subgraph group_runtime["Client replay runtime"]
  node_curl["cURL session parser<br/>[session.py]"]
  node_app["App base class<br/>[session.py]"]
  node_session["Session HTTP runtime<br/>[session.py]"]
end

subgraph group_unpin["Pinning bypass"]
  node_unpin["Unpin orchestration<br/>[unpin.py]"]
end

node_user(("App owner"))
node_mitmweb["mitmweb proxy"]
node_generator["AI code generator"]
node_generated["Generated API client"]
node_api["App API"]
node_scripts["Frida hook scripts"]
node_objection["Objection IPA patcher"]

node_user -->|"runs commands"| node_cli
node_cli -->|"launches proxy"| node_mitmweb
node_mitm -->|"reads flows"| node_mitmweb
node_cli -->|"loads HAR"| node_har
node_har -->|"uses host helpers"| node_discovery
node_cli -->|"lists endpoints"| node_discovery
node_mitm -->|"extracts endpoints"| node_discovery
node_discovery -->|"fetches bodies"| node_mitm
node_cli -->|"builds client prompt"| node_prompt
node_prompt -->|"submits prompt"| node_generator
node_generator -->|"writes client source"| node_generated
node_generated -->|"subclasses"| node_app
node_app -->|"inherits runtime"| node_session
node_session -->|"loads credentials"| node_mitm
node_session -->|"selects auth headers"| node_extract
node_session -->|"sends HTTP requests"| node_api
node_session -->|"parses pasted cURL"| node_curl
node_session -->|"loads HAR session"| node_har
node_cli -->|"dispatches unpin"| node_unpin
node_unpin -->|"fetches and configures"| node_scripts
node_unpin -->|"patches IPA"| node_objection

click node_cli "https://github.com/littledivy/mimic/blob/main/mimic/cli.py"
click node_mitm "https://github.com/littledivy/mimic/blob/main/mimic/sources/mitm.py"
click node_har "https://github.com/littledivy/mimic/blob/main/mimic/sources/har.py"
click node_curl "https://github.com/littledivy/mimic/blob/main/mimic/session.py"
click node_extract "https://github.com/littledivy/mimic/blob/main/mimic/extract.py"
click node_discovery "https://github.com/littledivy/mimic/blob/main/mimic/sources/mitm.py"
click node_prompt "https://github.com/littledivy/mimic/blob/main/mimic/codegen.py"
click node_app "https://github.com/littledivy/mimic/blob/main/mimic/session.py"
click node_session "https://github.com/littledivy/mimic/blob/main/mimic/session.py"
click node_unpin "https://github.com/littledivy/mimic/blob/main/mimic/unpin.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_mitm,node_har,node_extract,node_generated toneBlue
class node_cli,node_discovery,node_prompt toneAmber
class node_curl,node_app,node_session,node_api toneMint
class node_unpin toneRose
class node_user,node_mitmweb,node_generator,node_scripts,node_objection toneIndigo
```

## Components

### Capture and import

- [Mitm flow client](https://github.com/littledivy/mimic/blob/main/mimic/sources/mitm.py): `mimic/sources/mitm.py`
- [HAR importer](https://github.com/littledivy/mimic/blob/main/mimic/sources/har.py): `mimic/sources/har.py`
- [Auth extraction](https://github.com/littledivy/mimic/blob/main/mimic/extract.py): `mimic/extract.py`

### Endpoint discovery and generation

- [Mimic CLI](https://github.com/littledivy/mimic/blob/main/mimic/cli.py): `mimic/cli.py`
- [Host and endpoint discovery](https://github.com/littledivy/mimic/blob/main/mimic/sources/mitm.py): `mimic/sources/mitm.py`
- [Prompt and endpoint digest](https://github.com/littledivy/mimic/blob/main/mimic/codegen.py): `mimic/codegen.py`

### Client replay runtime

- [cURL session parser](https://github.com/littledivy/mimic/blob/main/mimic/session.py): `mimic/session.py`
- [App base class](https://github.com/littledivy/mimic/blob/main/mimic/session.py): `mimic/session.py`
- [Session HTTP runtime](https://github.com/littledivy/mimic/blob/main/mimic/session.py): `mimic/session.py`

### Pinning bypass

- [Unpin orchestration](https://github.com/littledivy/mimic/blob/main/mimic/unpin.py): `mimic/unpin.py`

### Other components

- **App owner**
- **mitmweb proxy**
- **AI code generator**
- **Generated API client**
- **App API**
- **Frida hook scripts**
- **Objection IPA patcher**

## Connections

- App owner → Mimic CLI: runs commands (evidence: `README.md`)
- Mimic CLI → mitmweb proxy: launches proxy (evidence: `mimic/cli.py`)
- Mitm flow client → mitmweb proxy: reads flows (evidence: `mimic/sources/mitm.py`)
- Mimic CLI → HAR importer: loads HAR (evidence: `mimic/cli.py`)
- HAR importer → Host and endpoint discovery: uses host helpers (evidence: `mimic/sources/har.py`)
- Mimic CLI → Host and endpoint discovery: lists endpoints (evidence: `mimic/cli.py`)
- Mitm flow client → Host and endpoint discovery: extracts endpoints (evidence: `mimic/sources/mitm.py`)
- Host and endpoint discovery → Mitm flow client: fetches bodies (evidence: `mimic/sources/mitm.py`)
- Mimic CLI → Prompt and endpoint digest: builds client prompt (evidence: `mimic/cli.py`)
- Prompt and endpoint digest → AI code generator: submits prompt (evidence: `mimic/codegen.py`)
- AI code generator → Generated API client: writes client source
- Generated API client → App base class: subclasses (evidence: `README.md`)
- App base class → Session HTTP runtime: inherits runtime (evidence: `mimic/session.py`)
- Session HTTP runtime → Mitm flow client: loads credentials (evidence: `mimic/session.py`)
- Session HTTP runtime → Auth extraction: selects auth headers (evidence: `mimic/session.py`)
- Session HTTP runtime → App API: sends HTTP requests (evidence: `README.md`)
- Session HTTP runtime → cURL session parser: parses pasted cURL (evidence: `mimic/session.py`)
- Session HTTP runtime → HAR importer: loads HAR session (evidence: `mimic/session.py`)
- Mimic CLI → Unpin orchestration: dispatches unpin (evidence: `mimic/cli.py`)
- Unpin orchestration → Frida hook scripts: fetches and configures (evidence: `mimic/unpin.py`)
- Unpin orchestration → Objection IPA patcher: patches IPA (evidence: `mimic/unpin.py`)
