An open-source, interactive, context-aware browser mascot pet companion extension built using the clawd-pet SVG library. The pet crawls along the edges of your browser viewport, monitors your activity, and updates its expression in response to your browsing context and site errors!
Mascot SVG assets are adapted from the open-source clawd-pet library by Abderrahim Ghazali, used under the MIT License.
-C75D3F?logo=googlechrome&logoColor=white&style=for-the-badge){kind=icon}
- Gravity-Driven Physics Engine: Reliable floor/ceiling crawling with a built-in Gravity Engine, spring-physics, and intelligent edge-snapping (no more wall-sticking).
- Context-Aware Emotions: Real-time expressions that react to typing speed, scroll depth, media playback, intent detection, and site errors.
- Lite Mode (Default): Efficient, rule-based behavior analysis using Regex and meta-tag analysis—zero downloads or API keys required.
- Brain Upgrade (Optional AI): Privacy-first, high-fidelity sentiment analysis using an on-device DistilBERT model. Features Gemini Nano integration to summarize full page DOM bodies natively, specifically targeting semantic
<main>and<article>tags to prevent context-window overflow, complete with an 8-second safety timeout. - Distraction-Free UI: Schedule Focus Blocks to force Arcrawls into a quiet studying animation, or use Ghost Mode to automatically fade his opacity down to 30% whenever you are actively typing or scrolling.
- Performance Mode: Halts cross-tab syncing and disables CSS aura shaders to save memory and CPU on low-end machines. Movement now utilizes a single GPU-composited
translate3dupdate per frame to eliminate layout thrashing. - Virtual Pet Progression: Level up your pet through interactions, unlock costumes, and develop unique personality traits based on your browsing habits.
- Mascot Milestones: Track significant growth markers, interaction records, and trait evolutions in a dedicated achievement dashboard.
- 24-Hour AI Synapse: Get daily generative reflections on your browsing habits synthesized by Gemini Nano (Brain Upgrade required).
- Comprehensive Dashboard: Track 7-day interest analytics, manage work/sleep schedules, and customize domain-specific reactions.
- 10 Languages: Full UI and speech-bubble localization for English, Spanish, French, German, Italian, Brazilian Portuguese, Japanese, Simplified Chinese, Korean, and Hindi. Follows the browser language by default, or force one in Options → Interface Language.
| Component | Size | When |
|---|---|---|
| Chrome Web Store download | ~6 MB | Compressed install package |
| Installed on disk (Chrome details) | ~22–25 MB | Pet assets + bundled ONNX WASM |
| Lite Mode core (assets + UI) | ~2 MB unpacked | Active by default (Regex rules) |
| ONNX WASM runtime (bundled) | ~22 MB unpacked | Included; initialized when Brain Upgrade is on |
| DistilBERT model weights | ~67 MB | Downloaded once from Hugging Face after you opt in |
Lite Mode works immediately with no network downloads. The optional Brain Upgrade initializes the bundled WASM runtime and adds a one-time ~67 MB model fetch to your browser cache — your browsing text never leaves the device.
- Navigate to the extension directory:
cd context-aware-browser-pet- Install the dev dependencies:
bun installYou can run the following scripts using Bun:
bun run dev- Starts Vite in watch mode for local development.bun run build- Builds the extension for Chrome/Chromium to thedist/folder.bun run build:firefox- Builds the extension for Firefox to thedist-firefox/folder.bun run test- Runs the Vitest unit test suite.bun run test:e2e- Runs Playwright end-to-end browser tests.bun run verify- Runs TypeScript type-checking, unit tests, and E2E tests.bun run all- Compiles the Chrome build, runs all verifications, and compiles the Firefox build.
- Open Chrome and navigate to
chrome://extensions. - Toggle on Developer mode in the top-right corner.
- Click the Load unpacked button in the top-left corner.
- Select the
dist/directory located inside thecontext-aware-petfolder. - Open any webpage (e.g. github.com) — your pet will slide onto the page! 🐾
- Build the Firefox bundle:
bun run build:firefox- Open Firefox and navigate to
about:debugging#/runtime/this-firefox. - Click Load Temporary Add-on....
- Select
dist-firefox/manifest.jsoninside thecontext-aware-petfolder. - Open any normal HTTPS webpage (e.g. github.com) to verify that Arcrawls appears.
Firefox currently runs Arcrawls in Lite Mode. The local Brain Upgrade and centralized offscreen audio paths depend on Chrome offscreen documents, which Firefox does not support yet.
Arcrawls ships with full interface and pet-speech localization in 10 languages:
| Code | Language | Code | Language | |
|---|---|---|---|---|
en |
English | ja |
日本語 (Japanese) | |
es |
Español (Spanish) | zh_CN |
中文（简体） (Simplified Chinese) | |
fr |
Français (French) | ko |
한국어 (Korean) | |
de |
Deutsch (German) | hi |
हिन्दी (Hindi) | |
it |
Italiano (Italian) | pt_BR |
Português (Brasil) |
How it works:
- By default, Arcrawls follows your browser's UI language (
chrome.i18n). - Open the Sanctuary → Mascot & Style page and use the Interface Language dropdown to force a specific language — the dashboard, popup, onboarding, the pet's speech bubbles, and AI reaction comments all switch instantly.
- Each locale lives in
public/_locales/<code>/messages.json. UI strings use named keys (e.g.options_*), while the pet's dialogue uses hash-derived keys (speech_<fnv1a32>), authored in English in code and extracted byscripts/gen-speech-keys.mjs. - To add a new language: create
public/_locales/<code>/messages.jsonwith the full key set (copy fromenas a starting point), add it toSUPPORTED_LOCALESinsrc/shared/locale.ts, then runnode scripts/gen-speech-keys.mjsandnode scripts/merge-speech.mjs <code>to sync thespeech_*keys.
This project is open-source under the PolyForm Noncommercial License 1.0.0.
⚠️ PolyForm Noncommercial License Notice:
Free for personal use, hobby projects, educational institutions, public research, and noncommercial pursuits.
Commercial distribution, resale, or monetization of this software or derivative works is strictly prohibited without explicit written permission from the author (fujidevv@duck.com).
Underlying mascot SVG assets are adapted from the open-source clawd-pet library and used under the MIT License.
Arcrawls is engineered to be 100% on-device with zero server uploads and zero telemetry. Read our full Privacy Policy for a detailed breakdown of host permissions, local ONNX/Gemini model downloads, private-page exclusions, and user data controls.