Frequently Asked Questions

An iPhone with iOS 26 or later, and a Mac running the free Mac CLI review-server companion. The iPhone app does not work on its own.

Yes. Real sync, Inbox updates, document content, and Agent Handoff all require the Mac CLI review-server. Sample data mode lets you look at the interface without connecting a server, but it does not sync anything real.

Yes. The Mac CLI companion is free. Reading and commenting on one project in the iPhone app is also free; SpecDock Pro unlocks unlimited projects, Comment Groups, custom comment tags, and Agent Handoff.

Run npx specdock@latest init on your Mac (or npx specdock@latest init . to register the current project too). There is nothing to download or build. See the CLI companion page for the full walkthrough.

Use the manual URL printed in the Mac CLI output. Tailscale, LAN/Bonjour, and manual URL are all connection routes, not SpecDock authorization, so pairing is still required either way.

On the same Wi-Fi, SpecDock finds your Mac automatically over Bonjour and you pick it from the list. You can also scan the QR code the CLI prints, or type the 6-digit pairing code by hand.

Add it from the app: SpecDock lists the projects it finds on your Mac, or you can use Add by Path to type a folder path and let your Mac validate it. You can also run npx specdock@latest init . inside a project on your Mac to register it from the command line.

iOS asks for Local Network permission when SpecDock uses LAN/Bonjour to find or connect to a Mac review-server. It is not needed for the Tailscale or manual URL routes.

No. Tailscale is one optional route to reach your Mac from outside your Wi-Fi. Normal setup and pairing work over LAN/Bonjour or a manual URL too.

Open a document from the Inbox or a project's file tree, then tap the passage you want to comment on, or select text to quote it. Choose a severity, Must, Should, Question, Reject, or Idea, and save.

Yes. The reader's "…" menu has Copy document, which copies the document's raw Markdown to your clipboard so you can paste it into a chat LLM or another app.

No. Agent Handoff writes AI-readable review output to .specdock/review/. Your coding agent and your normal review process still need to apply and check any changes.

All Clear means there are no open review items in SpecDock right now. It says nothing about security, legal compliance, implementation quality, or release readiness.

SpecDock does not try to be a collaborative team tool, a cloud sync service, a web editor, a GitHub pull request review replacement, an issue tracker, or a tool that edits your code for you.

Purchases and subscriptions are handled through the App Store, so refunds follow Apple's App Store policies. For anything else, see the Support page.