How renattt121/aggle works
Aggle is a browser-extension companion that combines network ad blocking, an AI sidebar, browser settings and resource profiles, and supporting new-tab, command-palette, and stats surfaces. The main user workflows are configuring features in Options and using the sidebar to chat with an AI provider, optionally with page context; the background coordinates blocker startup and extension messages. The graph includes major features visible in the tree, but unsampled new-tab and stats internals are not inferred. Edges reflect the provided excerpts or SOURCE INDEX references.
Main entry points: panel.ts Sidebar panel · engine.ts Request blocker · storage.ts Settings storage · background.ts Background router
Components 21
Network blocking
- Bundled filters
aggle/extension/src/blocker/lists.ts - Filter parser
aggle/extension/src/blocker/parser.ts - Request blocker
aggle/extension/src/blocker/engine.ts - Blocker controls
aggle/extension/src/blocker/ui.ts
AI sidebar
- Sidebar panel
aggle/extension/src/sidebar/panel.ts - Chat builder
aggle/extension/src/sidebar/chat.ts - Provider registry
aggle/extension/src/sidebar/providers/registry.ts - Streaming client
aggle/extension/src/sidebar/client.ts - Markdown renderer
aggle/extension/src/sidebar/markdown.ts
Settings and profiles
- Options UI
aggle/extension/src/options/options.ts - User.js preferences
aggle/extension/src/utils/prefs.ts
Browser surfaces
- Page context script
aggle/extension/src/content.ts - Command palette
aggle/extension/src/sidebar/palette.ts - Custom new tab
aggle/extension/src/newtab/newtab.ts - Stats dashboard
aggle/extension/src/stats/dashboard.ts
Shared runtime
- Background router
aggle/extension/src/background.ts - Settings storage
aggle/extension/src/utils/storage.ts - Extension local storage
Other components
- Extension user
- Browser runtime
- AI provider APIs
Connections 24
- Extension user → Options UI: configures
- Options UI → Settings storage: loads and saves
aggle/extension/src/options/options.ts - Options UI → User.js preferences: generates snippet
aggle/extension/src/options/options.ts - Settings storage → Extension local storage: reads and writes
aggle/extension/src/utils/storage.ts - Background router → Request blocker: initializes
aggle/extension/src/background.ts - Background router → Blocker controls: refreshes badge
aggle/extension/src/background.ts - Request blocker → Settings storage: loads settings
aggle/extension/src/blocker/engine.ts - Request blocker → Filter parser: parses filters
aggle/extension/src/blocker/engine.ts - Request blocker → Bundled filters: uses bundled rules
aggle/extension/src/blocker/engine.ts - Request blocker → Browser runtime: intercepts requests
aggle/extension/src/blocker/engine.ts - Request blocker → Extension local storage: writes block stats
aggle/extension/src/blocker/engine.ts - Extension user → Sidebar panel: uses sidebar
- Sidebar panel → Settings storage: loads and persists
aggle/extension/src/sidebar/panel.ts - Sidebar panel → Provider registry: selects provider
aggle/extension/src/sidebar/panel.ts - Sidebar panel → Streaming client: streams chat
aggle/extension/src/sidebar/panel.ts - Sidebar panel → Chat builder: builds messages
aggle/extension/src/sidebar/panel.ts - Sidebar panel → Markdown renderer: renders responses
aggle/extension/src/sidebar/panel.ts - Sidebar panel → Page context script: extracts page context
aggle/extension/src/sidebar/panel.ts - Streaming client → AI provider APIs: sends chat requests
aggle/extension/src/sidebar/client.ts - Provider registry → Settings storage: loads custom providers
aggle/extension/src/sidebar/providers/registry.ts - Page context script → Command palette: uses palette
aggle/extension/src/content.ts - Background router → Stats dashboard: opens dashboard
aggle/extension/src/background.ts - Stats dashboard → Settings storage: reads stats data
aggle/extension/src/stats/dashboard.ts - Extension user → Custom new tab: opens new tab