Installation

Install the csp CLI with Homebrew, the install script, a JavaScript package manager, or Cargo.

The MCP server needs no install step: bunx @pleaseai/csp mcp fetches the package on first use. Install the CLI when you want csp on your PATH for AGENTS.md instructions, the sub-agent, or scripting.

Install the CLI

macOS and Linux. Ships a standalone binary, so no Node or Bun is required at runtime.

brew install pleaseai/tap/csp

Downloads the standalone binary from the GitHub release for your platform, verifies its checksum, and drops it in ~/.local/bin.

curl -fsSL https://raw.githubusercontent.com/pleaseai/code-search/main/scripts/install.sh | bash

Override the destination with CSP_INSTALL_DIR, or pin a release:

curl -fsSL https://raw.githubusercontent.com/pleaseai/code-search/main/scripts/install.sh | bash -s -- --version v0.1.7

The npm package ships the same binary behind a small Node launcher, so this path needs Bun or Node 22+ on your PATH.

bun add -g @pleaseai/csp     # with bun (recommended)
npm install -g @pleaseai/csp # or with npm
pnpm add -g @pleaseai/csp    # or with pnpm

Compiles the standalone binary locally. The crate is published as code-search-please (the short name csp was already taken); the installed binary is still csp.

cargo install code-search-please

Verify

csp --version
csp search "authentication flow" .

If csp is not on $PATH, use bunx @pleaseai/csp in its place (for example bunx @pleaseai/csp search "query" .).

Update

brew upgrade csp                     # Homebrew
bun update -g @pleaseai/csp          # with bun
npm update -g @pleaseai/csp          # with npm
pnpm update -g @pleaseai/csp         # with pnpm
cargo install code-search-please     # Cargo (rebuilds the latest release)