README.md

PleaseAI Homebrew Tap

Official Homebrew tap for PleaseAI tools.

What is this?

This is a Homebrew tap (third-party repository) that provides formulae for installing PleaseAI command-line tools.

Installation

Quick Install

Install any formula directly:

brew install pleaseai/tap/csp
brew install pleaseai/tap/asana-cli
brew install pleaseai/tap/notion-cli

Tap First (Optional)

Or add the tap first, then install:

brew tap pleaseai/tap
brew install csp
brew install asana-cli
brew install notion-cli

Available Formulae

csp

Fast and accurate hybrid code search for agents (semantic + BM25). Ships as a self-contained binary — no Node.js or Bun required.

Installation:

brew install pleaseai/tap/csp

Usage:

csp --help
csp search "where is auth handled" .
csp index .
csp mcp   # run the MCP server

Repository: pleaseai/code-search

asana-cli

Manage your Asana tasks from the command line.

Installation:

brew install pleaseai/tap/asana-cli

Usage:

asana --help
asana auth login --token YOUR_TOKEN
asana task list -a me

Repository: pleaseai/asana

notion-cli

Manage Notion from the command line.

Installation:

brew install pleaseai/tap/notion-cli

Usage:

notion --help
notion auth login --token YOUR_NOTION_TOKEN
notion page list
notion database list

Repository: pleaseai/notion

shunt

Claude Code LLM gateway — an Anthropic Messages proxy that routes models to OpenAI/Codex and Anthropic-compatible backends.

Installation:

brew install pleaseai/tap/shunt

Usage:

shunt --help
shunt run --config shunt.toml     # start the gateway
shunt check --config shunt.toml   # validate the config

Repository: pleaseai/shunt

Updating

Update all installed formulae from this tap:

brew upgrade

Or update a specific formula:

brew upgrade csp
brew upgrade asana-cli
brew upgrade notion-cli

Uninstalling

Remove a formula:

brew uninstall csp
brew uninstall asana-cli
brew uninstall notion-cli

Remove the tap:

brew untap pleaseai/tap

How It Works

This tap is automatically updated by GitHub Actions whenever a new release is published to the respective tool repositories.

The formulae are maintained at:

• csp: csp.rb
• asana-cli: asana-cli.rb
• notion-cli: notion-cli.rb

Contributing

Formulae in this tap are automatically generated and updated. Please do not submit manual updates.

If you find issues with a formula, please open an issue in the respective tool's repository:

• csp issues: pleaseai/code-search/issues
• asana-cli issues: pleaseai/asana/issues
• notion-cli issues: pleaseai/notion/issues

License

MIT