Getting docs (not found) after both brew install and bash install methods

[bikrrr]

Sorry to bother you (again 😬), but I'm having an issue trying to get v0.5.0 to work. I've tried both install methods mentioned in your blog post:

• brew install mihaelamj/tap/cupertino
• bash <(curl -sSL https://raw.githubusercontent.com/mihaelamj/cupertino/main/install.sh)
  (deleting the .cupertino folder in between)

But they both result in the docs showing as (not found)

Here's the output after each command…

cupertino setup --force

📦 Cupertino Setup

⚠️  Existing databases will be overwritten

⬇️  Downloading Databases...
   ⠋ Starting download...
   ✓ Databases (320.0 MB)
📂 Extracting databases...
   ✓ Extracted

✅ Setup complete!
   Documentation: /Users/uhl/.cupertino/search.db
   Sample code:   /Users/uhl/.cupertino/samples.db

💡 Start the server with: cupertino serve

cupertino serve

✅ Documentation search enabled (index found)
✅ Sample code search enabled (index found)
🚀 Cupertino MCP Server starting...
   Search DB: /Users/uhl/.cupertino/search.db
   Samples DB: /Users/uhl/.cupertino/samples.db
   Waiting for client connection...
ℹ️  Server started and waiting for initialization

cupertino doctor

🏥 MCP Server Health Check

✅ MCP Server
   ✓ Server can initialize
   ✓ Transport: stdio
   ✓ Protocol version: 2024-11-05

📚 Documentation Directories
   ✗ Apple docs: /Users/uhl/.cupertino/docs (not found)
     → Run: cupertino fetch --type docs
   ⚠  Swift Evolution: /Users/uhl/.cupertino/swift-evolution (not found)
     → Run: cupertino fetch --type evolution
   ⚠  HIG: /Users/uhl/.cupertino/hig (not found)
     → Run: cupertino fetch --type hig

🔍 Search Index
   ✓ Database: /Users/uhl/.cupertino/search.db
   ✓ Size: 1776.9 MB
   ✓ Frameworks: 287

🔧 Providers
   ✓ DocsResourceProvider: available
   ✓ SearchToolProvider: available

⚠️  Some checks failed - see above for details

What am I doing wrong?

[bikrrr]

I tried again with 0.7.0, but I still couldn’t get the one-step download/setup working, so I ended up fetching everything manually. It took a few hours, but everything seems to be running fine—I can ask an LLM SwiftUI questions and it appears to be referencing Apple docs correctly.

One odd thing: cupertino doctor reports “0 files” for Apple docs, even though the server otherwise looks healthy.

🏥 MCP Server Health Check

✅ MCP Server
   ✓ Server can initialize
   ✓ Transport: stdio
   ✓ Protocol version: 2024-11-05

📚 Documentation Directories
   ✓ Apple docs: /Users/uhl/.cupertino/docs (0 files)
   ✓ Swift Evolution: /Users/uhl/.cupertino/swift-evolution (429 proposals)
   ✓ HIG: /Users/uhl/.cupertino/hig (173 pages)

🔍 Search Index
   ✓ Database: /Users/uhl/.cupertino/search.db
   ✓ Size: 213.6 MB
   ✓ Frameworks: 220

🔧 Providers
   ✓ DocsResourceProvider: available
   ✓ SearchToolProvider: available

✅ All checks passed - MCP server ready

Not sure if this is a minor bug or something off in my configuration. Either way, it’s working now, so it’s not a pressing issue. Still, it’d be nice to understand why the one-step download/setup doesn’t work for me.