Go to file
Mihaela Mihaljevic 850b706c47 data: merge Apr 30 recrawl backup with size heuristic, archive churn
Merges /Volumes/Code2/cupertino-backup-2026-04-30-pre-recrawl/ (the
in-progress JSON-only recrawl from Claw, 345k files / 2.2 GB) into
docs/ with the rule "keep the larger version per file". Adds 84,226
new pages and replaces 36,278 with larger versions; leaves 224,653
unchanged where the existing Mar 13 file was equal-or-larger.

Archives 9 frameworks that Apple has removed or renamed in the
~6 weeks since the Mar 13 baseline, into _archive/2026-03-13/:

  Removed (now 404 on developer.apple.com):
    availability, cocoa, objective-c, performance, sensitivecontent

  Renamed/relocated (URL still resolves but under a different slug):
    passkit_apple_pay_and_wallet  →  passkit
    safariextensions              →  safariservices/safari_app_extensions
    touchcontrols                 →  touchcontroller
    carekit                       →  carekit-apple/CareKit (separate hierarchy)

Net effect: docs/ goes from 319,191 → 403,370 files (+26 %).

The 224,653 skipped files are notable — for those pages, the older
Mar 13 extractor produced richer content than the in-progress
JSON-only crawl. A WKWebView-only crawl (in flight on Claw) should
produce a fuller corpus and re-update docs/ when it completes.
2026-05-01 00:45:39 +02:00
_archive/2026-03-13
archive
docs
hig
packages
swift-evolution
swift-org
wwdc-research
.gitattributes
LICENSE
README.md

Cupertino Docs

Pre-crawled Apple and Swift documentation for use with Cupertino - an MCP server providing Apple Developer documentation for AI assistants.

Current Release: v0.9.0 — 234,331 documents across 287 frameworks

Contents

Folder Description Source
docs/ Apple Developer Documentation (287 frameworks) developer.apple.com
swift-evolution/ Swift Evolution Proposals github.com/swiftlang/swift-evolution
swift-org/ Swift.org Documentation swift.org
packages/ Swift Package Documentation swiftpackageindex.com
sample-code/ Apple Sample Code Projects developer.apple.com
archive/ Apple Legacy Archive Guides developer.apple.com/library/archive

Top Frameworks by Document Count

Framework Documents
Kernel 24,747
Matter 22,013
Swift 17,466
AppKit 14,066
Foundation 10,988

Quick Start

Clone directly to the default Cupertino location:

git clone https://github.com/mihaelamj/cupertino-docs.git ~/.cupertino

Or download pre-built databases from Releases (~320 MB zip).

Updates

This repository is periodically updated with fresh crawls. Check releases for dated snapshots.

To crawl your own fresh copy, use the main Cupertino tool:

cupertino fetch --type all

This repository contains cached copies of publicly available documentation for offline use and AI training purposes.

This repository is provided as-is for convenience. For authoritative documentation, refer to the original sources.