AI Suggestions

Overview

The AI suggestions feature sends your source-language value to an AI model and returns a draft translation. You can accept the draft, edit it, or reject it — the final decision is always yours.

The app currently uses Google Gemini as the AI provider. You need a Gemini API key to use this feature.

---

Setting up your API key

1. Go to aistudio.google.com and create a free API key.
2. In the app, open Settings (gear icon in the header).
3. Paste your key in the Gemini API Key field and click Save.

The key is stored in your OS keychain (macOS Keychain / Windows DPAPI) — not in a plain text file. It is never included in git commits or PRs.

Tip

In development builds, the key is stored in the Tauri Store instead of the keychain (unsigned binaries trigger repeated macOS prompts). This is intentional and only affects dev builds.

---

Requesting a suggestion

In the editor, hover over any editable cell and click the sparkle (✨) icon that appears. The app calls the Gemini API with the source value and inserts the result as a draft.

The draft appears in the cell with a draft badge. From there:

• Accept — click the checkmark or press Enter to confirm the draft as your translation.
• Edit — type over the draft to refine it before accepting.
• Reject — press Escape or click the X to discard the draft and return to the previous value.

---

Tips

• AI suggestions work best for short, clear values. Long strings with complex formatting may need more editing.
• The suggestion is context-free — the model only sees the source value, not surrounding keys. Add context in your edit if the translation requires it.
• Plural forms: the app requests all plural variants in a single call. Review each variant after accepting.