Getting Started

Getting Started

This guide will help you install and configure Aletheia.

---

Prerequisites

• Chrome 88+ or Firefox 109+
• Modern operating system (Windows, macOS, Linux)

---

Installation

Chrome Web Store (Recommended)

Coming soon — Store submission in progress

Firefox Add-ons

Coming soon — Store submission in progress

Manual Installation (Development)

For developers who want to test the latest version:

Chrome

1. Download or clone the repository:

   git clone https://github.com/martymcenroe/Aletheia.git

2. Open Chrome and navigate to chrome://extensions/

3. Enable Developer mode (toggle in top-right)

4. Click Load unpacked

5. Select the extensions/chrome folder

6. The Aletheia icon should appear in your toolbar

Firefox

1. Download or clone the repository:

   git clone https://github.com/martymcenroe/Aletheia.git

2. Open Firefox and navigate to about:debugging

3. Click This Firefox in the sidebar

4. Click Load Temporary Add-on

5. Select manifest.json from the extensions/firefox folder

---

First Use

1. Sign in — Click the Aletheia icon and sign in with LinkedIn (required for API access)

2. Navigate to any webpage with text content

3. Select a word or phrase you want to analyze

4. Right-click and choose "Explain with AI" from the context menu

5. View the analysis overlay showing:

   • Signal indicator (educational context level)
   • Etymology gem (key historical insight)
   • Full context explanation

---

Permissions Explained

Aletheia requests minimal permissions:

Permission	Purpose
contextMenus	Add "Explain with AI" to right-click menu
activeTab	Access selected text on current tab only
storage	Save your preferences locally

Privacy note: Aletheia does NOT request <all_urls> or blanket host permissions. See Privacy Policy for full details.

---

Troubleshooting

Extension icon not appearing

• Ensure Developer mode is enabled
• Try reloading the extension
• Check for errors in chrome://extensions/

"Explain with AI" not in context menu

• Make sure you've selected text before right-clicking
• Try refreshing the page
• Verify the extension is enabled

Analysis not loading

• Check your internet connection
• Verify you're signed in (click the Aletheia icon to check)
• You may have hit a rate limit — check the error message for reset time

"Unauthorized" error

• Your JWT may have expired (24-hour lifetime)
• Click the Aletheia icon → Sign Out → Sign In again

---

Next Steps

• Read the User Guide for detailed usage instructions
• Check the FAQ for common questions
• Report issues on GitHub

---

Last updated: 2026-02-19