# brijr/iris architecture

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

## Overview

Iris turns a URL into a screenshot through either its CLI or its local stdio MCP server. Both paths prepare capture options and use the shared Chrome DevTools capture engine; CLI captures are written to files, while MCP returns inline image data and structured metadata, with an optional file output. The README documents viewport, full-page, selector, batch, format, and waiting capabilities. Some capture internals are only partially excerpted, so the graph omits uncertain internal call relationships.

Main entry points: [`src/capture.rs`](https://github.com/brijr/iris/blob/main/src/capture.rs) (Chrome session), [`src/mcp.rs`](https://github.com/brijr/iris/blob/main/src/mcp.rs) (MCP server), [`src/main.rs`](https://github.com/brijr/iris/blob/main/src/main.rs) (Capture scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_cli_entry["CLI dispatch<br/>[main.rs]"]
  node_url_batch["URL batching<br/>[main.rs]"]
  node_cli_options["Capture options<br/>[main.rs]"]
  node_cli_scheduler["Capture scheduler<br/>[main.rs]"]
end

subgraph group_capture["Capture engine"]
  node_chrome_session["Chrome session<br/>[capture.rs]"]
  node_page_readiness["Page readiness<br/>[capture.rs]"]
  node_capture_modes["Capture modes<br/>[capture.rs]"]
  node_image_result["Captured image<br/>[capture.rs]"]
end

subgraph group_mcp["MCP service"]
  node_mcp_server["MCP server<br/>[mcp.rs]"]
  node_mcp_validation["Request preparation<br/>[mcp.rs]"]
  node_mcp_state["Session and permits<br/>[mcp.rs]"]
  node_mcp_result["Inline tool result<br/>[mcp.rs]"]
end

subgraph group_results["Outputs"]
  node_file_output["Image files<br/>[main.rs]"]
  node_cli_report["CLI reports<br/>[main.rs]"]
end

node_cli_user(("CLI user"))
node_mcp_client(("MCP client"))
node_chrome["Chrome browser"]
node_web_pages["Live web pages"]

node_cli_user -->|"runs command"| node_cli_entry
node_mcp_client -->|"calls tool"| node_mcp_server
node_cli_entry -->|"dispatches MCP"| node_mcp_server
node_cli_entry -->|"starts capture"| node_url_batch
node_cli_entry -->|"builds options"| node_cli_options
node_cli_entry -->|"runs captures"| node_cli_scheduler
node_url_batch -->|"provides targets"| node_cli_scheduler
node_cli_options -->|"configures captures"| node_cli_scheduler
node_cli_scheduler -->|"requests captures"| node_chrome_session
node_cli_scheduler -->|"writes images"| node_file_output
node_cli_scheduler -->|"prints reports"| node_cli_report
node_chrome_session -->|"drives via CDP"| node_chrome
node_chrome_session -->|"renders pages"| node_web_pages
node_chrome_session -->|"waits for content"| node_page_readiness
node_chrome_session -->|"captures mode"| node_capture_modes
node_chrome_session -->|"returns image"| node_image_result
node_mcp_server -->|"prepares request"| node_mcp_validation
node_mcp_server -->|"requests capture"| node_mcp_state
node_mcp_validation -->|"supplies options"| node_mcp_state
node_mcp_state -->|"launches session"| node_chrome_session
node_mcp_server -->|"returns image and metadata"| node_mcp_result
node_mcp_server -->|"optionally writes"| node_file_output

click node_cli_entry "https://github.com/brijr/iris/blob/main/src/main.rs"
click node_url_batch "https://github.com/brijr/iris/blob/main/src/main.rs"
click node_cli_options "https://github.com/brijr/iris/blob/main/src/main.rs"
click node_cli_scheduler "https://github.com/brijr/iris/blob/main/src/main.rs"
click node_chrome_session "https://github.com/brijr/iris/blob/main/src/capture.rs"
click node_page_readiness "https://github.com/brijr/iris/blob/main/src/capture.rs"
click node_capture_modes "https://github.com/brijr/iris/blob/main/src/capture.rs"
click node_image_result "https://github.com/brijr/iris/blob/main/src/capture.rs"
click node_mcp_server "https://github.com/brijr/iris/blob/main/src/mcp.rs"
click node_mcp_validation "https://github.com/brijr/iris/blob/main/src/mcp.rs"
click node_mcp_state "https://github.com/brijr/iris/blob/main/src/mcp.rs"
click node_mcp_result "https://github.com/brijr/iris/blob/main/src/mcp.rs"
click node_file_output "https://github.com/brijr/iris/blob/main/src/main.rs"
click node_cli_report "https://github.com/brijr/iris/blob/main/src/main.rs"

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_entry,node_url_batch,node_cli_options,node_cli_scheduler,node_cli_user,node_mcp_client,node_chrome toneBlue
class node_chrome_session,node_page_readiness,node_capture_modes,node_image_result toneAmber
class node_mcp_server,node_mcp_validation,node_mcp_state,node_mcp_result toneMint
class node_file_output,node_cli_report toneRose
class node_web_pages toneIndigo
```

## Components

### Entry points

- [CLI dispatch](https://github.com/brijr/iris/blob/main/src/main.rs): `src/main.rs`
- [URL batching](https://github.com/brijr/iris/blob/main/src/main.rs): `src/main.rs`
- [Capture options](https://github.com/brijr/iris/blob/main/src/main.rs): `src/main.rs`
- [Capture scheduler](https://github.com/brijr/iris/blob/main/src/main.rs): `src/main.rs`

### Capture engine

- [Chrome session](https://github.com/brijr/iris/blob/main/src/capture.rs): `src/capture.rs`
- [Page readiness](https://github.com/brijr/iris/blob/main/src/capture.rs): `src/capture.rs`
- [Capture modes](https://github.com/brijr/iris/blob/main/src/capture.rs): `src/capture.rs`
- [Captured image](https://github.com/brijr/iris/blob/main/src/capture.rs): `src/capture.rs`

### MCP service

- [MCP server](https://github.com/brijr/iris/blob/main/src/mcp.rs): `src/mcp.rs`
- [Request preparation](https://github.com/brijr/iris/blob/main/src/mcp.rs): `src/mcp.rs`
- [Session and permits](https://github.com/brijr/iris/blob/main/src/mcp.rs): `src/mcp.rs`
- [Inline tool result](https://github.com/brijr/iris/blob/main/src/mcp.rs): `src/mcp.rs`

### Outputs

- [Image files](https://github.com/brijr/iris/blob/main/src/main.rs): `src/main.rs`
- [CLI reports](https://github.com/brijr/iris/blob/main/src/main.rs): `src/main.rs`

### Other components

- **CLI user**
- **MCP client**
- **Chrome browser**
- **Live web pages**

## Connections

- CLI user → CLI dispatch: runs command (evidence: `README.md`)
- MCP client → MCP server: calls tool (evidence: `README.md`)
- CLI dispatch → MCP server: dispatches MCP (evidence: `src/main.rs`)
- CLI dispatch → URL batching: starts capture (evidence: `src/main.rs`)
- CLI dispatch → Capture options: builds options (evidence: `src/main.rs`)
- CLI dispatch → Capture scheduler: runs captures (evidence: `src/main.rs`)
- URL batching → Capture scheduler: provides targets (evidence: `src/main.rs`)
- Capture options → Capture scheduler: configures captures (evidence: `src/main.rs`)
- Capture scheduler → Chrome session: requests captures (evidence: `src/main.rs`)
- Capture scheduler → Image files: writes images (evidence: `src/main.rs`)
- Capture scheduler → CLI reports: prints reports (evidence: `src/main.rs`)
- Chrome session → Chrome browser: drives via CDP (evidence: `src/capture.rs`)
- Chrome session → Live web pages: renders pages (evidence: `README.md`)
- Chrome session → Page readiness: waits for content (evidence: `README.md`)
- Chrome session → Capture modes: captures mode (evidence: `src/capture.rs`)
- Chrome session → Captured image: returns image (evidence: `src/main.rs`)
- MCP server → Request preparation: prepares request (evidence: `src/mcp.rs`)
- MCP server → Session and permits: requests capture (evidence: `src/mcp.rs`)
- Request preparation → Session and permits: supplies options (evidence: `src/mcp.rs`)
- Session and permits → Chrome session: launches session (evidence: `src/mcp.rs`)
- MCP server → Inline tool result: returns image and metadata (evidence: `src/mcp.rs`)
- MCP server → Image files: optionally writes (evidence: `src/mcp.rs`)
