-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Marty McEnroe edited this page Feb 19, 2026
·
7 revisions
Aletheia (Greek: ἀλήθεια) — "truth" or "disclosure" — the state of not being hidden.
Aletheia is an AI-powered browser extension that helps users understand the historical context and etymology of words and phrases. It acts as a "Digital Etymologist," providing educational insights about language evolution and cultural context embedded in everyday terminology.
| Section | Description |
|---|---|
| Getting Started | Installation and first steps |
| User Guide | How to use Aletheia |
| Architecture | Technical system design |
| Developer Guide | Contributing and development |
| API Reference | Backend API documentation |
| Security | Security policy and practices |
| Privacy | Privacy policy |
| FAQ | Frequently asked questions |
- Etymology Analysis — Understand the origins and evolution of words
- Context-Aware — Considers the surrounding text for disambiguation
- Privacy-First — Minimal permissions, anonymized logging, no browsing history access
- Multi-Browser — Supports Chrome (Manifest V3) and Firefox (Manifest V2)
- Educational Focus — Designed to inform, not judge
- JWT Authentication — LinkedIn OAuth sign-in with sub-millisecond local validation
- Tiered Subscriptions — Free tier with generous limits, premium via Stripe
- Rate Limiting — Per-user multi-window caps (hourly, daily, monthly)
- Admin Dashboard — CloudWatch metrics, subscription management, ID resolution tools
- Select text on any webpage
- Right-click and choose "Explain with AI"
-
View the analysis in an overlay showing:
- Signal indicator (educational context level)
- Etymology gem (key historical insight)
- Full context explanation
| Layer | Technology |
|---|---|
| Frontend | Browser Extension (JavaScript) |
| Edge | CloudFlare Workers (rate limiting, DDoS protection) |
| Backend | AWS Lambda (Python 3.12) — Agent + Auth |
| AI | AWS Bedrock (Anthropic Claude) |
| State | AWS DynamoDB (agent state, users, token cap, coupons) |
| Auth | LinkedIn OAuth → JWT (HS256) → Secrets Manager |
| Billing | Stripe (subscriptions, webhooks, checkout) |
| Observability | CloudWatch (EMF metrics, X-Ray, 14-day retention) |
Aletheia is in active development, targeting Chrome Web Store and Firefox Add-ons publication.
| Milestone | Status |
|---|---|
| Core Extension | ✅ Complete |
| AWS Backend | ✅ Complete |
| Digital Etymologist | ✅ Complete |
| Security Hardening | ✅ Complete |
| CloudFlare Migration | ✅ Complete |
| LinkedIn OAuth | ✅ Complete |
| JWT Authentication | ✅ Complete |
| Tiered Rate Limiting | ✅ Complete |
| Stripe Billing | ✅ Complete |
| Admin Dashboard | ✅ Complete |
| Store Submission | 🔄 In Progress |
Aletheia is open source under the MIT License.
Last updated: 2026-02-19
Aletheia — AI-Powered Context Analysis | MIT License | Report Security Issue
Wiki verified: 2026-02-19