cupertino v1.3.0: The Big Refactor
v1.3.0 is the architecture release: eight per-source databases derived from one registry, shipped read-only, with the legacy unified search.db retired for good.
All articles
The Morlocks Built SwiftUI
The cynical read is that Apple kept the real tools and handed us toys. But the same engineer built Core Animation in 2007 and co-built SwiftUI in 2019, and that one fact says the opposite. On why the foundation never left, and the debt that comes due the day the abstraction breaks.
cupertino v1.2.0: lands the right Apple doc 9 times in 10
Search-quality release. AI coding assistants now land the right Apple documentation page on the first try 9 times out of 10, up from 5 out of 10 in v1.1.0. Cross-validated on three independent corpora, zero regressions. The architecture, and what it still gets wrong, in writing.
Cupertino v1.1.0: my Apple docs index was 30% lies and I didn't know
A 3 a.m. SQL query found one row of HTTP poison in the search index. Pulling on that thread unraveled 13 ways Apple's CDN lies to crawlers, plus a release bug where the binary cheerfully downgraded every user to the previous bundle.
Why I built OpenAPIDoctor
OpenAPIKit's strict parser meets real-world specs. A typed diagnosis CLI with auto-repair, proven across 594 YAML files.
Cupertino v1.0.2: the duplicate that `LOWER(uri)` could not see
A third of the search index was the same Apple page indexed twice. The verification query that "proved" it wasn't could not have seen the bug. What v1.0.2 ships, and three takeaways from the audit.
Cupertino v1.0.0 "First Light"
First release stable across crawl, index, rank, serve, and distribute. Search that finally returns the right answer, one bundle, MCP spec 2025-11-25.
Cupertino v0.10: Full Coverage and Community Contributions
307 frameworks, 302,424 docs, Agent Skills, Claude Code plugin, and the first community PRs.
iRelay: Text Your Mac, Run an AI Agent
A Swift daemon that turns iMessage into a remote terminal for Claude Code
Cupertino v0.9: Multi-Agent Support and MCP Protocol Upgrade
Cupertino now works with OpenAI Codex, Cursor, VS Code Copilot, Zed, Windsurf, and opencode. Plus MCP protocol upgrade to 2025-06-18.
Cupertino v0.8.0: AST Indexing and a Major Architecture Refactor
SwiftSyntax enables semantic code search. A deep refactoring of the codebase delivers cleaner results and better AI capabilities.
Cupertino v0.7.0: 302K Docs, OS Version Filtering, and Teaching AI to Dig Deeper
The complete Apple documentation crawl is done. Now you can filter by iOS 17+ and Claude finally knows where to look for answers.
Cupertino v0.5.0: 234K Docs, 287 Frameworks, and the Roadmap Ahead
The biggest documentation update yet - nearly double the docs, plus what's coming next for the Apple documentation MCP server.
Cupertino v0.4.0: HIG Support, Framework Aliases, and Release Engineering Lessons
New features for Apple documentation search, plus a cautionary tale about release processes and why order matters when tagging.
Cupertino v0.3.4: One-Line Install & 150K+ Apple Docs
Install Cupertino with a single command - signed, notarized, and ready in seconds. Now with 150,000+ Apple documentation pages.
Cupertino v0.3.0: From 20 Hours to 30 Seconds
The new setup command downloads pre-built databases instantly - no more crawling Apple's documentation for hours
Cupertino: 27 Issues Down, Just Getting Started
From MCP server to a complete Apple documentation ecosystem with pre-crawled docs and 606 sample projects
Cupertino: Offline Apple Documentation for AI Agents
An MCP server that gives Claude Desktop offline access to 22,000+ Apple documentation pages
Building a Concurrency-Safe Bearer Token Middleware for Swift OpenAPI Clients
Elegant, Thread-Safe Authentication for OpenAPI Runtime
From ExtremePackaging to OpenAPI Integration
Building a Full OpenAPI Workflow on Top of the Extreme Packaging Architecture
Introducing OpenAPILoggingMiddleware
Elegant, Structured Request Logging for OpenAPI-Driven Swift Servers
ExtremePackaging
Example of Extreme Packaging in Swift
CVBuilder: A Swift Package for Professional CV Management
A Swift package for building and rendering CVs in multiple formats
Bringing Advanced SwiftUI Animations to macOS
A port of SwiftUILab's Advanced Animations that also supports macOS
Core Animation Layers forming a 3D cube
Core Animation in 2.5D