Frequently Asked Questions

📬What exactly does Quetix do?

Quetix connects to one or more email inboxes and, every minute, pulls new messages and converts them into structured tickets. For each email, it uses Claude to extract a priority, category, contact, company, sentiment, product area, a one-sentence summary, and a routing suggestion. Those fields are editable and used to populate your dashboard, filter views, and route work.

☁️Is my data sent to the cloud?

The storage is local. Your tickets, source credentials, and configuration live in a SQLite database on the machine running Quetix. The only external call is to Anthropic's Claude API when you have an API key configured — this sends the email content to Claude for extraction.

📮Which email providers are supported?

Anything that speaks IMAP. Presets are provided for:

• Gmail — use an app password (2-step verification must be on)
• Outlook / Office 365 — IMAP host outlook.office365.com
• iCloud Mail — requires an app-specific password
• Custom IMAP — any provider with standard IMAP access

Slack, webhook, and Gmail/Outlook OAuth sources are on the near-term roadmap.

🤖How accurate is the AI extraction?

Claude Haiku (the default) hits roughly 95% field accuracy on typical support email. Sonnet does a few points better on ambiguous cases and is a drop-in swap via the INTRAY_MODEL env var. Every extracted field is editable on the ticket, and future versions will use corrections to fine-tune routing.

For critical routing (outage, security), don't rely on the confidence score alone — scan the raw email.

💸How much does the Claude API cost?

With Claude Haiku and prompt caching on the system prompt, extraction runs roughly $0.02–$0.05 per 1,000 emails. Sonnet is ~5× that. You can cap costs with MAX_MESSAGES_PER_SYNC in .env.

🔐Where are credentials stored?

In the local SQLite database at server/data/intray.db. This is suitable for a trusted machine with full-disk encryption. Moving credentials into the system keychain (macOS Keychain / Windows Credential Manager / libsecret) is on the roadmap.

🛑Can Quetix send email or modify my mailbox?

No. Quetix only reads INBOX since the last sync. It does not send, mark as read, move, or delete messages. You can verify this in the source — see server/src/imap.ts.

🔁How do I re-sync an inbox manually?

Click the refresh icon in the top bar. It calls POST /api/sync, which runs every active source immediately regardless of the normal 60-second cadence.

📤Can I export my tickets?

Yes — the SQLite file at server/data/intray.db is standard SQLite3. Export with sqlite3 intray.db .dump or any GUI tool (TablePlus, DBeaver). A one-click CSV export is available on the Tickets page.

🧪Can I try it without connecting a real inbox?

Yes. On first boot, Quetix seeds three demo tickets so the dashboard is populated. You can also use the New ticket button to paste an email and see the full extraction pipeline without connecting a mailbox.

🖥️What platforms does Quetix run on?

Quetix ships as a desktop app for macOS and Windows (Electron), as an iOS companion app (bundle ID net.quetix.souriapps), and as a self-hosted repo you can run from source with Node 20+.

📄Related