Skip to content
Agents tracked: 502 Releases (7d): 762 Agent status: no reported issuesSince last limit reset: Claude 11d · Codex 9d For AI agents: Markdown Updated Nov 22, 2026

Sosumi

by NSHipster

Apple developer docs your AI assistant can read.

Search and knowledgeRemote

GitHubWebsite

1. Made by

“This is an unofficial, independent project and is not affiliated with or endorsed by Apple Inc.”

It reads Apple's documentation but is not made by Apple. The repository belongs to NSHipster and the README calls it an unofficial, independent project.

github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/README.md

Checked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error

What Sosumi does

Apple's developer documentation only shows up in a browser that runs scripts, so AI assistants often cannot read it. Sosumi turns those pages, Apple's design guidelines and WWDC talk transcripts into plain text the assistant can read. It is free, needs no account and only reads; it changes nothing on your computer.

What people use it for

Correct Swift code from your assistant

When the assistant writes an iPhone or Mac app, it reads the current Apple page for each building block instead of guessing from memory.

Read one Apple page as plain text

Take any developer.apple.com documentation address and get the same page as plain text, in a browser or from the command line.

Follow Apple's design rules

Ask how buttons, colors or layout should look on iPhone, and the assistant reads Apple's Human Interface Guidelines for the answer.

Learn from a WWDC talk

Give the assistant a WWDC session link and it reads the full transcript, so it can summarize the talk or use its advice in your code.

Docs for Swift packages

Many Swift packages publish their docs in Apple's DocC format on their own sites. Sosumi reads those pages too.

Catch up on this year's WWDC Idea

Ask the assistant to read the sessions about the frameworks your app uses and list what changed for you.

Sosumi popularity

492
GitHub stars, NSHipster/sosumi.ai
0
public agent projects connect it
Sosumi: GitHub starsNSHipster/sosumi.ai 492

Tools it gives your agent (4)

What it sends and its license

Sends

the search text, documentation path or address the tool is called with

To sosumi.ai (Cloudflare Workers), then Apple's documentation site or search, or the Swift-DocC host you name; on each tool call. Opt out: use the command-line tool, which fetches from Apple directly.

Sends

IP address and headers of requests that fail or end abnormally

To Cloudflare logs, kept up to 7 days; only for errors and unusual requests. Opt out: none on the hosted server.

The code is free under the MIT license. The Apple pages it shows stay Apple's; follow Apple's terms and do not use it to republish Apple content.

In a paid app
Yes

The code is MIT; Apple's content you read through it stays under Apple's terms.

“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction” source

Pass on its files
No

Do not republish the Apple pages you get through it; the code itself may be shared with its MIT notice.

“Do not use this service to circumvent technical measures or for redistribution.” source

Is it alive

Latest version

1.1.1 in the registry, updated Nov 9, 2026

Last release

1.1.1 on npm and in server.json (2026-11-09)

Remote endpoint
yes: https://sosumi.ai/mcp answered 406 (expects an MCP client) to one plain GET on 2026-11-10

Alternatives

Sosumi This page

492 starsRemote

Context7

Pick it if you need current docs for many libraries outside Apple, such as web frameworks

65K starsRemotein 1323 projects

io-github-yamadashy-repomix

Pick it if the assistant should read a whole code repository, not documentation pages

Local

All search and knowledge servers

Get started

Tell your AI assistant

“Connect the Sosumi server at https://sosumi.ai/mcp and, before you write any SwiftUI code, fetch the Apple docs for each API you use and check its availability.”

Connect it

claude mcp add --transport http sosumi https://sosumi.ai/mcp

No account and no key. Claude Code can also install the plugin, which adds the server and a Sosumi skill. The README gives no Codex server config; any client with remote server support uses the same URL.

Mistakes to avoid

Fetching https://developer.apple.com/documentation/... with a plain web fetch
Swap the host to sosumi.ai or call fetchAppleDocumentation with the path

Apple's pages need JavaScript, so a plain fetch gets only a notice.

fetchAppleDocumentation with a guessed path
Search with searchAppleDocumentation first, then fetch the best match

The skill's workflow says to search when the exact path is unknown.

Fetching a broad top-level page such as /documentation/swiftui to answer a specific question
Fetch the specific symbol page, such as /documentation/swiftui/view

Symbol pages carry the exact signatures and availability.

Looping over many pages to copy a whole framework's docs
Fetch only the pages the task needs

The service is on-demand, rate limited, and not for bulk download or redistribution.

Questions

Do I need an account or a key?

No. It has no accounts and does not ask for personal information.

Is it made by Apple?

No. It is an independent project, not affiliated with or endorsed by Apple.

Can I use it without the hosted server?

Yes. The command-line tool runs on your computer and fetches from Apple directly, without sending requests to sosumi.ai.

Does it keep what I search for?

It has no database and does not save requests; only errors and unusual requests are logged, for up to 7 days.