Apple’s developer documentation is vast and constantly updated, but accessing it efficiently outside of Xcode has always been a bit of a challenge. XCDocs solves this by exposing the exact same vector database that backs Xcode’s built-in DocumentationSearch as a local, searchable resource. This means you get the same search quality and completeness without the overhead of maintaining your own doc index.
how XCDocs exposes Apple developer documentation locally
XCDocs is a Swift CLI and package designed for macOS 26+ on Apple silicon with Xcode 26.3 RC. It acts as a thin wrapper around Apple’s existing documentation infrastructure. Instead of building and maintaining a separate documentation index or search engine, it directly queries the vector database that powers Xcode’s MCP-based DocumentationSearch tool.
This vector database approach means the documentation is always in sync with Apple’s latest releases, and the search experience mirrors what developers get inside Xcode. The repo provides two main interfaces:
- A CLI with commands such as
xcdocs searchfor querying andxcdocs getfor retrieving specific documentation entries. - A Swift API for programmatic access, enabling integration with other tools or AI agents.
Additionally, XCDocs includes built-in configurations for AI agent “skills” that work with Codex and Claude Code, enabling automated or assisted documentation lookup workflows.
Under the hood, the architecture is minimal and pragmatic. The code doesn’t implement complex search algorithms or indexing layers but relies on Apple’s vector database, accessed via MCP tooling. This means the repo’s maintenance burden is low, and it benefits directly from improvements in Xcode’s doc search.
what makes XCDocs stand out technically
The cleverness of XCDocs lies in reusing Apple’s existing vector database rather than duplicating effort with a separate index. Most local doc search tools either:
- Download and parse documentation sets themselves,
- Build their own full-text or vector indexes,
- Or rely on online search APIs.
XCDocs sidesteps all this by piggybacking on the exact same data Xcode uses. This ensures:
- Instant access to the freshest documentation,
- Search quality tuned by Apple’s engineers,
- No need for manual sync jobs or index rebuilds.
The tradeoff is a hard dependency on macOS 26+, Apple silicon, and Xcode 26.3 RC, which limits its portability and adoption in mixed or older environments.
Examining the code reveals a clean Swift package split between CLI commands and API modules. The CLI commands are straightforward wrappers over the MCP queries. There’s also thoughtful inclusion of agent skill configurations, which suggests this was designed with AI integration in mind from the start.
The repo stays minimal — no heavy dependencies, no custom search engines. This keeps the footprint small and the codebase maintainable but means it inherits any limitations of Apple’s vector database and MCP tooling.
install and get started with xcdocs
The simplest way to install XCDocs is via Homebrew:
brew install BitrigApp/tap/xcdocs
Alternatively, you can download a prebuilt CLI binary from the Releases page and move it to /usr/local/bin for system-wide use.
If you prefer building from source, clone the repo and run:
swift build
The resulting binary will be located at .build/debug/xcdocs.
Once installed, basic usage looks like this:
xcdocs search <query>
xcdocs get <doc-identifier>
These commands let you search across the Apple developer docs locally and fetch detailed entries.
who should consider using XCDocs
XCDocs is a neat tool for Swift developers and Apple platform engineers who want fast, local access to Apple’s developer documentation without relying on Xcode’s UI or online browsing.
It is particularly suited for:
- Developers working on Apple silicon machines running macOS 26 or later,
- Teams building AI agents or CLI tools that need programmatic access to Apple docs,
- Anyone who prefers terminal-based workflows or integrating doc search into custom tooling.
The main limitation is the platform specificity. If you work on older macOS versions, Intel Macs, or cross-platform environments, XCDocs won’t be a fit.
Also, since it doesn’t maintain its own index, any gaps or limitations in Apple’s vector database are inherited directly.
Overall, the repo is a lean, pragmatic approach to a common problem: local, high-quality Apple documentation search that stays up to date with zero maintenance. For the right setup, it’s a solid addition to your developer toolkit.
Related Articles
- OpenAI Codex CLI: local-first AI coding assistant with ChatGPT integration — OpenAI Codex CLI brings AI coding assistance local to your terminal, integrating with ChatGPT plans for powerful hybrid
→ GitHub Repo: BitrigApp/XCDocs ⭐ 178 · Swift