Frequently Asked Questions

Short answers. Email support@kodexiai.com if yours isn't here.

Getting started

What does Kodexi do?: It captures text from your reading apps (Kindle, Apple Books), builds a searchable, chapter-aware library, and lets you study via chat, flashcards, and audio explanations.
How does capture work?: On macOS, Kodexi watches the active app and captures the visible page via ScreenCaptureKit when you switch pages. Text is extracted with Apple Vision (on-device). On iOS, you import via the Share extension or PDF upload.
Does it work offline?: Capture, OCR, search, and RAG retrieval all work offline. Chat, audio explanations, and cloud OCR fallback require internet.

Can Kodexi (or anyone at Kodexi) read what I capture?: No. Your captures and chats are encrypted on your device with AES-256-GCM before they ever leave it. The encryption key lives in your device Keychain and is never sent to our servers. We technically cannot decrypt your content.
What about the AI features — doesn't the AI provider see my text?: Yes, for the duration of each request. When you send a chat message or ask for a flashcard, the specific text needed for that operation is sent to a third-party LLM provider (Google Gemini or OpenRouter). Providers see only what is necessary for that request and are contractually prohibited from training on or retaining your data. Full details in our Privacy Policy.
How do I delete my data?: Settings → Account → Delete Account. This permanently removes all encrypted content from our servers, all telemetry, and all billing records linked to your account. Your local device data is wiped on next launch.

How do I sync between my Mac and iPhone?: Sign in with the same account on both devices. Sync is end-to-end encrypted; your encryption key is derived from your account password.
What if I forget my password?: You can reset your password to recover account access. However, because sync is end-to-end encrypted, content uploaded with the old key cannot be decrypted by the new key. New captures will sync normally; older encrypted content remains accessible only on devices that still hold the original key.
Can I export my data?: Yes — Settings → Account → Export. You get a JSON file with all your captures, chats, chapters, flashcards, and pinned passages in plain text. Email support@kodexiai.com if you need it in another format.

How much does it cost?: Free tier with daily AI quota. Paid tiers unlock higher quotas, audio explanations, cross-workspace search, and research mode. Prices shown at the paywall and in the App Store / Stripe checkout.
What's the difference between the iOS and macOS subscriptions?: iOS uses Apple In-App Purchase. macOS uses Stripe (Apple does not allow third-party IAP for direct-distribution macOS apps). Your subscription is shared across devices via your account, regardless of which platform processed the payment.
How do I cancel?: iOS: Settings → Apple ID → Subscriptions → Kodexi → Cancel. macOS: Kodexi → Settings → Subscription → Manage → Cancel (opens the Stripe customer portal).
Can I get a refund?: iOS refunds are handled by Apple via reportaproblem.apple.com. macOS refunds: Brazilian consumers have a 7-day right of regret under CDC Art. 49; contact support@kodexiai.com within 7 days of purchase.

Capture stopped working after a macOS update.: System Settings → Privacy & Security → Screen Recording → enable Kodexi. macOS revokes ScreenCaptureKit permission on major updates.
OCR is missing pages or showing garbage.: Increase your reader's text size. Vision OCR works best at 14pt+ on a sharp display. For tougher pages, Kodexi falls back to cloud OCR automatically.
I can't see the Research / Cross-workspace Search / Audio cloud features.: These features are remote-flag gated. If they're not visible, the feature is currently disabled for new installs. Existing users on the feature continue to have access. We turn features back on as we scale capacity.
How do I report a bug?: Email support@kodexiai.com with a description and, if you can, the steps to reproduce. Include the version (Settings → About) and your OS version.