jason/ThunderAI
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ThunderAI/CLAUDE.md

3.4 KiB
Raw Blame History

ThunderAI - Claude Code Guide

Project Overview

ThunderAI is a Thunderbird WebExtension (Manifest V2) that integrates multiple AI providers (ChatGPT Web, OpenAI API, Google Gemini, Claude/Anthropic, Ollama, and OpenAI-compatible APIs) directly into the Thunderbird email client.

  • Extension ID: thunderai@micz.it
  • Min Thunderbird: 140.0+
  • Language: Plain ES6+ JavaScript modules — no build tools, no transpilation, no npm
  • License: GPLv3

Key Rules

  1. Localization: Modify ONLY _locales/en/messages.json. All other locale files are managed via Weblate — never touch them.
  2. No build system: There is no bundler, compiler, or package manager. All JS files are plain ES6 modules loaded directly by the browser engine.
  3. Module imports: Use relative paths with .js extension (e.g., import { foo } from '../js/mzta-utils.js').
  4. Placeholder format: Placeholders in prompt text use the {%placeholder_id%} syntax (e.g., {%mail_text_body_or_selected%}).
  5. No test suite: There is no automated test framework. Testing is done manually in Thunderbird.
  6. Settings defaults: All new preferences must be added to options/mzta-options-default.js in prefs_default.

Directory Map

/
├── mzta-background.js      # Background script (main entry point)
├── mzta-background.html    # Loads the background script
├── manifest.json           # Extension manifest
├── js/                     # Core modules
│   ├── api/                # AI API integration modules
│   ├── workers/            # Web Workers (one per API provider)
│   ├── lib/                # Third-party libraries (diff.js)
│   └── mzta-*.js           # Core utilities, menus, prompts, placeholders
├── options/                # Settings UI
│   ├── mzta-options.html/.js/.css
│   ├── mzta-options-default.js   # ALL default preference values
│   └── mzta-release-notes.html
├── pages/                  # Feature-specific settings pages
│   ├── addtags/
│   ├── customprompts/
│   ├── customdataplaceholders/
│   ├── get-calendar-event/
│   ├── get-task/
│   ├── spamfilter/
│   ├── summarize/
│   └── onboarding/
├── popup/                  # Popup menu (shown on toolbar click)
│   └── mzta-popup.html/.js/.css
├── _locales/               # Localization
│   ├── en/messages.json    # ← ONLY THIS FILE is edited directly
│   └── [15 other languages managed by Weblate]
├── images/                 # Icons and graphical assets
└── api_webchat/            # Web chat API interface

Spec Files

For detailed documentation see claude-spec/: