Reconstruction of the Raycast Companion browser extension for learning purposes. TypeScript sources mirror the original Parcel bundles while keeping the runtime behavior intact.

• Overview
• Quick Start
• Extension Installation
• Raycast Proxy Installation
• Documentation
• License

This project provides:

• 🌐 Browser Extension: Reconstructed Raycast Companion extension for Chrome and Firefox
• 🔄 WebSocket Proxy: Server that enables Firefox to communicate with Raycast (required for Firefox due to origin restrictions)
• 📦 Multiple Installation Options: Install scripts, Homebrew formula, and pre-built binaries for all platforms

1. Clone and build:

   git clone https://github.com/Yukaii/raycast-context-bridge.git
   cd raycast-context-bridge
   npm install && npm run build

2. Load dist/chrome as an unpacked extension in Chrome

1. Install the proxy server (required):

   curl -fsSL https://raw.githubusercontent.com/Yukaii/raycast-context-bridge/main/scripts/install.sh | bash

2. Build and load the extension:

   npm install && npm run build
   # Load dist/firefox in Firefox (or run npm run firefox:zip)

3. Start the proxy:

   raycast-proxy

1. Install dependencies:

   npm install

2. Build the extension:

   npm run build

3. Load the extension in your browser:

   • Chrome: Load dist/chrome as an unpacked extension
   • Firefox: Load dist/firefox or create a ZIP with npm run firefox:zip (outputs to dist/firefox-artifacts/raycast-companion-firefox.zip)

1. In about:config, set xpinstall.signatures.required to false to allow unsigned add-ons
2. In about:addons, use the gear menu → "Install Add-on From File…" (or drag the ZIP onto the page)
3. Important: Firefox requires the proxy server (see below) due to origin restrictions

Raycast currently rejects moz-extension:// origins, so the Firefox extension requires the proxy workaround. See the Firefox guide for details.

The raycast-proxy is a WebSocket proxy server that enables the Firefox extension to communicate with Raycast by forwarding connections with the correct origin header.

Choose one of the following installation methods:

Works on macOS, Linux, and Windows. Automatically detects your platform and installs the latest release:

curl -fsSL https://raw.githubusercontent.com/Yukaii/raycast-context-bridge/main/scripts/install.sh | bash

Tap this repository with an explicit remote (the repo name isn't homebrew-*), then install:

# Tap with custom remote
brew tap Yukaii/raycast-context-bridge https://github.com/Yukaii/raycast-context-bridge

# Install
brew install Yukaii/raycast-context-bridge/raycast-proxy

# Start the proxy
raycast-proxy

# Or run as a background service
brew services start raycast-proxy

1. Download the binary for your platform from the releases page
2. Make it executable: chmod +x raycast-proxy-*
3. Run it: ./raycast-proxy-*

Available platforms:

• macOS (Intel & Apple Silicon)
• Linux (x64 & ARM64)
• Windows (x64 & ARM64)

cd proxy
go build -o raycast-proxy ./cmd/raycast-proxy
./raycast-proxy

Configure the proxy using environment variables or command-line flags:

# Using flags
raycast-proxy --listen-port 9999

# Using environment variables
RAYCAST_PROXY_PORT=9999 raycast-proxy

📖 Complete Installation Guide - Detailed instructions for all platforms, service setup, and troubleshooting

📦 Homebrew Guide - Homebrew-specific documentation and tips

• 📖 Proxy Installation Guide - Complete proxy installation instructions for all platforms
• 🍺 Homebrew Guide - Homebrew-specific documentation and tips
• 🦊 Firefox Setup - Firefox behavior, origin limitation, and proxy workaround
• 🔧 Project Structure - Reconstruction notes and project structure

See LICENSE for terms; Raycast Technologies Ltd. retains all rights to the original product and assets.