User Guide

User Guide

Learn how to use Aletheia effectively to understand language context and etymology.

---

Core Functionality

Analyzing Text

1. Select text on any webpage by clicking and dragging
2. Right-click to open the context menu
3. Click "Explain with AI"
4. Read the analysis in the overlay

Understanding the Response

Aletheia provides three key pieces of information:

Signal Indicator

A visual indicator showing the educational context level:

Level	Meaning
🟢 Green	Neutral terminology
🟡 Yellow	Some historical context worth knowing
🟠 Orange	Significant etymological backstory
🔴 Red	Strong historical/cultural implications

Etymology Gem

A concise one-liner capturing the most important historical insight about the term.

Full Explanation

Detailed context including:

• Word origins and evolution
• Historical usage
• Cultural significance
• Modern implications

---

Best Practices

What to Analyze

Aletheia works best with:

• Individual words or short phrases
• Proper nouns and place names
• Idioms and expressions
• Technical terminology
• Historical references

Selection Tips

• Be specific: Select the exact term you want to understand
• Include context: For phrases, select the complete expression
• Avoid long passages: Keep selections under ~50 words for best results

---

Privacy Considerations

What Aletheia Does

• Sends selected text to AWS for AI analysis
• Displays results in a temporary overlay
• Stores your preferences locally

What Aletheia Does NOT Do

• Track your browsing history
• Store your selections permanently
• Share data with third parties
• Access pages you don't explicitly analyze

---

Keyboard Shortcuts

Coming soon - Keyboard shortcuts are planned for a future release

---

Allowlist Management

You can configure which sites Aletheia operates on:

1. Click the Aletheia icon in your toolbar
2. Access Settings
3. Manage your site allowlist

---

Feedback and Support

• Bug reports: GitHub Issues
• Feature requests: GitHub Discussions
• Security issues: Security Policy