Pixel for Windsurf

Install Pixel

Pixel is a command-line tool: Windsurf runs the pixel binary, so install it first (macOS and Linux).

brew install LivioGama/tap/pixel

The install script is the other channel. Neither one changes any agent’s configuration.

What pixel install writes

Nothing for Windsurf. pixel doctor judges only what pixel install writes, so it does not see Windsurf’s rule.

Add the rule

Copy the rule the repository ships into your project:

mkdir -p .windsurf/rules
curl -fsSL https://raw.githubusercontent.com/LivioGama/pixel/main/.windsurf/rules/pixel.md -o .windsurf/rules/pixel.md

The rule is the protocol: which pixel command replaces grep, a whole-file read or git log, and when a native tool is still right. It starts by checking for the binary (command -v pixel).

Check it

pixel doctor .

It checks the binary, the daemon and this repository’s index, the parts Windsurf relies on once the rule is in place.

Remove it

Delete .windsurf/rules/pixel.md.