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.
Read more
Mihaela Mihaljević
I’m Mihaela. Senior iOS architect with fifteen-plus years on Apple platforms. I build AI-powered developer tools for the Apple ecosystem.
Currently shipping Cupertino, an open-source MCP server that gives Claude and other AI assistants offline access to Apple’s developer documentation. 700+ GitHub stars, featured in iOS Dev Weekly.
Latest: Cupertino v1.1.0, my Apple docs index was 30% lies and I didn’t know. Also see Speaking and Hire me.
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.
Read more
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.
Read more
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.
Read more
Why I built OpenAPIDoctor
OpenAPIKit's strict parser meets real-world specs. A typed diagnosis CLI with auto-repair, proven across 594 YAML files.
Read more
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.
Read more
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.
Read more
Cupertino v0.10: Full Coverage and Community Contributions
307 frameworks, 302,424 docs, Agent Skills, Claude Code plugin, and the first community PRs.
Read more
iRelay: Text Your Mac, Run an AI Agent
A Swift daemon that turns iMessage into a remote terminal for Claude Code
Read more
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.
Read more
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.
Read more
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.
Read more
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.
Read more
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.
Read more
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.
Read more
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
Read more
Cupertino: 27 Issues Down, Just Getting Started
From MCP server to a complete Apple documentation ecosystem with pre-crawled docs and 606 sample projects
Read more
Cupertino: Offline Apple Documentation for AI Agents
An MCP server that gives Claude Desktop offline access to 22,000+ Apple documentation pages
Read more
Building a Concurrency-Safe Bearer Token Middleware for Swift OpenAPI Clients
Elegant, Thread-Safe Authentication for OpenAPI Runtime
Read more
From ExtremePackaging to OpenAPI Integration
Building a Full OpenAPI Workflow on Top of the Extreme Packaging Architecture
Read more
Introducing OpenAPILoggingMiddleware
Elegant, Structured Request Logging for OpenAPI-Driven Swift Servers
Read more
CVBuilder: A Swift Package for Professional CV Management
A Swift package for building and rendering CVs in multiple formats
Read more
Bringing Advanced SwiftUI Animations to macOS
A port of SwiftUILab's Advanced Animations that also supports macOS
Read more