Installation

Prerequisites

• Firefox (any recent version)
• Node.js (v18 or later)
• Claude Code CLI installed and working

macOS

1. Clone the repository:

   git clone https://github.com/boot-industries/claudezilla.git
   cd claudezilla

2. Run the installer:

   ./install/install-macos.sh

   The installer does the following automatically:

   • Makes the native host script executable
   • Installs MCP server dependencies (npm install in mcp/)
   • Creates the native messaging manifest at ~/Library/Application Support/Mozilla/NativeMessagingHosts/claudezilla.json
   • Registers the MCP server in ~/.claude/mcp.json
   • Adds mcp__claudezilla__* to allowed permissions in ~/.claude/settings.json

3. Load the extension in Firefox:

   • Open about:debugging in Firefox
   • Click This Firefox in the sidebar
   • Click Load Temporary Add-on
   • Navigate to the extension/ directory and select manifest.json

4. Click the Claudezilla icon in the toolbar to verify the connection.

Linux

1. Clone the repository:

   git clone https://github.com/boot-industries/claudezilla.git
   cd claudezilla

2. Run the installer:

   ./install/install-linux.sh

   On Linux the native manifest is placed at ~/.mozilla/native-messaging-hosts/claudezilla.json. Everything else works the same as macOS.

3. Load the extension in Firefox using the same about:debugging steps described above.

Windows

1. Clone the repository:

   git clone https://github.com/boot-industries/claudezilla.git
   cd claudezilla

2. Run the PowerShell installer:

   .\install\install-windows.ps1

   The Windows installer uses named pipes for IPC instead of Unix sockets, sets ACL-based security on the pipe, and registers the native manifest in the Windows Registry.

3. Load the extension in Firefox via about:debugging as described above.

Verify Installation

Once installed, start a new Claude Code session and run:

Use firefox_navigate to open https://example.com

If Claude opens Firefox and navigates to the page, the installation is working.