Squash - Browser Memory Layer for AI

Squash adds an invisible memory layer to your browser, compressing every click into portable context for any AI agent.

What it does

Squash studies your browsing patterns, learns how you work, and automatically provides relevant context when you use AI tools like ChatGPT or Claude. No more re-explaining yourself to every new AI conversation.

Quick Start

1. Clone and build:

   git clone https://github.com/kstonekuan/squash-browser-memory.git
   cd squash-browser-memory
   pnpm install
   pnpm build
   

2. Install in Chrome:

   • Open chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked" → select the dist folder

3. Choose your AI provider (in extension settings):

   • Chrome AI (Local): Private, on-device analysis
   • Claude API: More powerful, requires API key

Key Features

• Ambient Analysis: Runs in the background, building understanding over time
• Smart Memory: Learns and refines patterns across sessions
• Privacy First: Local analysis by default, explicit consent for remote services
• Context Injection: Adds a "Context" button to ChatGPT and Claude that inserts relevant info from your browsing history

AI Provider Setup

Chrome AI (100% Local)

• Chrome 138+ required
• Enable in chrome://flags → "Prompt API for Gemini Nano"
• Update in chrome://components → "Optimization Guide On Device Model" (~22GB download)

Claude API (Remote)

• Get API key from Anthropic Console
• Enter in extension's Advanced Settings

Usage

1. Ambient Mode: Enable in Advanced Settings for automatic hourly analysis
2. Manual Analysis: Click "Analyze History" in the side panel
3. Context Injection: Type in ChatGPT/Claude → click "Context" → select relevant suggestions

Planned Features

• MCP Server Integration: Expose your browsing patterns and profile as an MCP (Model Context Protocol) server for other AI tools
• More AI Providers: Support for additional LLM providers beyond Chrome AI and Claude
• Enhanced Context Matching: Smarter relevance algorithms for context suggestions
• Workflow Automation: Detect and suggest automation for repetitive tasks

For Developers

pnpm dev     # Development with hot reload
pnpm build   # Build extension
pnpm check   # Run all quality checks
pnpm test    # Run tests

See ARCHITECTURE.md for technical details.

Privacy

• Local mode: Your data never leaves your device
• Remote mode: Data sent to API provider (requires explicit setup)
• All data stored locally in Chrome storage

Requirements

• Chrome 138+
• Node.js & pnpm
• ~22GB free space (for Chrome AI model)

Resources

• Simple Chromium AI - Our open source library for Chrome's built-in AI capabilities
• Mem0 Chrome Extension - Inspiration for context injection UX
• Chrome AI Prompt API - Official documentation for Chrome's built-in AI
• Anthropic TypeScript SDK - Official SDK for Claude API integration