Installation

Set up Code Blocker

Connect the browser extension to the coding agents you use. Everything runs locally, and each integration starts the bridge automatically.

Before you begin

Build from source

Install the prerequisites

Install Node.js 22.6 or newer, then download or clone the Code Blocker repository.

Install dependencies and build

Run these commands from the repository root:

npm install
npm run build

This creates the browser builds and packaged agent integrations under the dist directories.

Browser

Install the extension

Chrome

Load the unpacked development build.

1. Open chrome://extensions.

2. Turn on Developer mode.

3. Select Load unpacked.

4. Choose apps/browser-extension/dist_chrome.

Firefox

Load the temporary extension build.

1. Open about:debugging#/runtime/this-firefox.

2. Select Load Temporary Add-on.

3. Choose apps/browser-extension/dist_firefox/manifest.json.

4. Reload it from this page after rebuilding.

Coding agents

Install your integrations

Codex

Run from the Code Blocker repository root.

codex plugin marketplace add .
codex plugin add code-blocker@personal

Open /hooks in Codex and trust the Code Blocker hooks when prompted.

Claude Code

Run from the Code Blocker repository root.

claude plugin marketplace add .
claude plugin install code-blocker@code-blocker

Open /hooks in Claude Code and trust the Code Blocker hooks when prompted.

Cursor IDE and CLI

The same integration supports Cursor Agent in the IDE and cursor-agent in the terminal.

Copy dist/integrations/cursor to ~/.cursor/plugins/local/code-blocker, or create a symlink to it.

Restart Cursor. Confirm Code Blocker appears under Settings > Plugins, then verify its hooks under Settings > Hooks.

You are ready

Use your coding agent normally. Open the extension settings to change the default X, Twitter, and YouTube blocklist or pause blocking. No separate bridge process is required.