Email us
For anything not covered below — bug reports, feature requests, billing issues, or just hi — email support@kodeora.com. We typically reply within one business day.
Frequently asked questions
What macOS versions does Lumen support?
Lumen requires macOS 14 Sonoma or later. It's a universal binary that runs natively on both Apple Silicon (M-series) and Intel Macs. We recommend M-series for the best streaming performance.
Do I need an Anthropic account to use Lumen?
No. You have two options:
- Subscribe (annual or lifetime) and use our managed plan — no Anthropic account needed.
- Bring your own Anthropic API key from console.anthropic.com and use it for free in BYOK mode.
How do I add my own API key?
Open Lumen → Settings (⌘,) → API Key tab. Paste the key starting with sk-ant-
and click Validate & Save. The key is stored in your macOS Keychain — never in
plain text or transmitted to us.
Where are my chats stored?
Locally, in your sandboxed Application Support directory:
~/Library/Containers/com.kodeora.lumen/Data/Library/Application Support/Lumen/.
You can reveal it from Settings → Privacy → Reveal in Finder. Nothing is uploaded to our servers.
How do I cancel my subscription?
Subscriptions are managed through your Apple ID. Open System Settings → Apple ID → Media & Purchases → Subscriptions, find Lumen, and tap Cancel. You'll retain access until the end of the current billing period.
For refunds, use Apple's Report a Problem page — refunds are issued by Apple, not by us directly.
What models do I get on each plan?
- Free — Claude Haiku 4.5, up to 5 messages per day.
- Trial / Annual / Lifetime / BYOK — Haiku 4.5, Sonnet 4.5, and Opus 4.5, with unlimited messages (subject to Anthropic's API rate limits).
Can I export my chats?
Yes. Every chat has an "Export as Markdown" action in the header's overflow menu (…). The export
is a single .md file with all turns in order. There's no proprietary format
lock-in — your data is yours.
What about file uploads — is there a size limit?
You can attach up to 10 files per turn, with a combined cap of 30 MB. Supported types: PDF, DOCX, TXT, MD, CSV, JSON, PNG, JPG, JPEG, WebP, HEIC.
PDFs and images go to Claude as native multimodal blocks. Other text-based formats are extracted and inlined as quoted content. DOCX uses a built-in sandbox-safe extractor.
Why does the in-app browser sometimes fail to load a site?
Lumen's browser is a sandboxed WKWebView. A small number of sites block embedded WebViews (Cloudflare strict checks, some banks). Open the URL in Safari for those edge cases. If you hit this on a site you use often, let us know.
Is the in-app web search the same as Anthropic's web search?
Yes. When you toggle "Web search" on in the composer, your message includes Anthropic's built-in
web_search_20250305 tool. Claude runs the search server-side and returns answers
with citations. The citations open in Lumen's in-app browser.
Can I run multiple Claude models in parallel?
Each chat uses one model at a time, which you can switch from the model picker in the chat header or composer. To compare models on the same prompt, use the Branch action on an assistant message — it copies the chat history into a new chat where you can swap models and re-send.
How does the AI Tools suite work?
Each tool is a pre-prompted entry point. Clicking a tool creates a fresh chat seeded with that tool's system prompt and recommended model — e.g. SQL Query Builder uses Sonnet with a SQL expert prompt. You can detach the tool chip in the chat header at any time to remove its system prompt.
What's the difference between Personas and Projects?
- Personas are reusable AI characters with their own system prompt and starter questions. Click a persona to start a new chat seeded with it.
- Projects are containers that group related chats with a shared system prompt and attached files. New chats inside a project inherit that context from turn one.
I'm getting "Your API key is invalid." What now?
Check that the key starts with sk-ant- and was copied with no leading or trailing
whitespace. Visit console.anthropic.com/settings/keys
to confirm the key is active and your account has billing enabled. Then paste it again in
Settings → API Key.
How do I report a bug or request a feature?
Email support@kodeora.com with:
- Lumen version (Settings → About)
- macOS version
- Steps to reproduce, plus what you expected vs. what happened
- Screenshots if relevant
Keyboard shortcuts
⌘N— New chat⌘⇧N— New project⌘⇧P— New persona⌘T— New browser tab⌘W— Close active tab (browser)⌘F— Find in current chat⌘K— Quick switcher (chats, projects, personas, tools)⌘,— Settings⌘⏎— Send messageEsc— Cancel streaming response / close sheet
Status
We don't currently host a status page because Lumen itself has no backend dependencies — the
app talks directly to api.anthropic.com. For Anthropic API incidents, see
status.anthropic.com.