# oslook/cursor-ai-downloads architecture

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

- Interactive diagram: https://gitdiagram.com/oslook/cursor-ai-downloads
- Repository: https://github.com/oslook/cursor-ai-downloads

## Overview

This repository tracks official Cursor release download links and publishes them for users choosing current or older versions. Its primary path fetches the latest platform URLs, records release information, and updates the README’s download listings; users then select a version and download from Cursor’s official hosting. Separate maintenance scripts backfill missing Linux URLs and can incorporate Linux links into the README. The source excerpts show these scripts’ file and API operations, but do not establish that the maintenance scripts are automatically orchestrated.

Main entry points: [`README.md`](https://github.com/oslook/cursor-ai-downloads/blob/main/README.md) (Download listings), [`version-history.json`](https://github.com/oslook/cursor-ai-downloads/blob/main/version-history.json) (Version history), [`src/update-cursor-links.ts`](https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-cursor-links.ts) (Latest updater), [`src/backfill-linux-arm64.ts`](https://github.com/oslook/cursor-ai-downloads/blob/main/src/backfill-linux-arm64.ts) (ARM64 backfill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Release acquisition"]
  node_main["Latest updater"]
  node_cursor_api["Cursor download API"]
end

subgraph group_history["Version history"]
  node_history_data[("Version history")]
  node_arm64_backfill["ARM64 backfill"]
  node_linux_backfill["Linux link backfill"]
end

subgraph group_publishing["Link publishing"]
  node_history_readme["History README updater"]
  node_linux_readme["Linux README updater"]
end

subgraph group_catalog["Release catalog"]
  node_readme["Download listings<br/>[README.md]"]
  node_product_catalog[("Version product records")]
end

node_user(("Version seeker"))
node_official_downloads["Cursor downloads"]

node_main -->|"fetches URLs"| node_cursor_api
node_main -->|"updates history"| node_history_data
node_main -->|"updates listings"| node_readme
node_arm64_backfill -->|"fetches URLs"| node_cursor_api
node_arm64_backfill -->|"reads and saves"| node_history_data
node_linux_backfill -->|"reads and saves"| node_history_data
node_history_readme -->|"reads history"| node_history_data
node_history_readme -->|"updates listings"| node_readme
node_linux_readme -->|"reads history"| node_history_data
node_linux_readme -->|"updates listings"| node_readme
node_user -->|"browses versions"| node_readme
node_readme -->|"links downloads"| node_official_downloads
node_user -->|"chooses version"| node_product_catalog

click node_main "https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-cursor-links.ts"
click node_history_data "https://github.com/oslook/cursor-ai-downloads/blob/main/version-history.json"
click node_arm64_backfill "https://github.com/oslook/cursor-ai-downloads/blob/main/src/backfill-linux-arm64.ts"
click node_linux_backfill "https://github.com/oslook/cursor-ai-downloads/blob/main/src/backfill-missing-linux-links.ts"
click node_history_readme "https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-readme-from-history.ts"
click node_linux_readme "https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-readme-with-linux-links.ts"
click node_readme "https://github.com/oslook/cursor-ai-downloads/blob/main/README.md"
click node_product_catalog "https://github.com/oslook/cursor-ai-downloads/tree/main/cursor_products"

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_main,node_cursor_api toneBlue
class node_history_data,node_arm64_backfill,node_linux_backfill toneAmber
class node_history_readme,node_linux_readme toneMint
class node_readme,node_product_catalog toneRose
class node_user,node_official_downloads toneIndigo
```

## Components

### Release acquisition

- [Latest updater](https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-cursor-links.ts): `src/update-cursor-links.ts`
- **Cursor download API**

### Version history

- [Version history](https://github.com/oslook/cursor-ai-downloads/blob/main/version-history.json): `version-history.json`
- [ARM64 backfill](https://github.com/oslook/cursor-ai-downloads/blob/main/src/backfill-linux-arm64.ts): `src/backfill-linux-arm64.ts`
- [Linux link backfill](https://github.com/oslook/cursor-ai-downloads/blob/main/src/backfill-missing-linux-links.ts): `src/backfill-missing-linux-links.ts`

### Link publishing

- [History README updater](https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-readme-from-history.ts): `src/update-readme-from-history.ts`
- [Linux README updater](https://github.com/oslook/cursor-ai-downloads/blob/main/src/update-readme-with-linux-links.ts): `src/update-readme-with-linux-links.ts`

### Release catalog

- [Download listings](https://github.com/oslook/cursor-ai-downloads/blob/main/README.md): `README.md`
- [Version product records](https://github.com/oslook/cursor-ai-downloads/tree/main/cursor_products): `cursor_products`

### Other components

- **Version seeker**
- **Cursor downloads**

## Connections

- Latest updater → Cursor download API: fetches URLs (evidence: `src/update-cursor-links.ts`)
- Latest updater → Version history: updates history (evidence: `src/update-cursor-links.ts`)
- Latest updater → Download listings: updates listings (evidence: `src/update-cursor-links.ts`)
- ARM64 backfill → Cursor download API: fetches URLs (evidence: `src/backfill-linux-arm64.ts`)
- ARM64 backfill → Version history: reads and saves (evidence: `src/backfill-linux-arm64.ts`)
- Linux link backfill → Version history: reads and saves (evidence: `src/backfill-missing-linux-links.ts`)
- History README updater → Version history: reads history (evidence: `src/update-readme-from-history.ts`)
- History README updater → Download listings: updates listings (evidence: `src/update-readme-from-history.ts`)
- Linux README updater → Version history: reads history (evidence: `src/update-readme-with-linux-links.ts`)
- Linux README updater → Download listings: updates listings (evidence: `src/update-readme-with-linux-links.ts`)
- Version seeker → Download listings: browses versions (evidence: `README.md`)
- Download listings → Cursor downloads: links downloads (evidence: `README.md`)
- Version seeker → Version product records: chooses version (evidence: `README.md`)
