Getting Started

pear is a CLI teaching tool that watches you code and proactively teaches during natural pauses. It doesn't write code for you — it helps you understand what you're writing and why.

Install

Go install

go install github.com/MitchTheStonky/pear/cli@latest

Homebrew

brew install MitchTheStonky/pear/pear

curl

curl -fsSL https://raw.githubusercontent.com/MitchTheStonky/pear/main/install.sh | sh

Setup

Run the init wizard to configure your name, preferred languages, experience level, and API key:

pear init

This creates ~/.pear/config.toml with your settings. You can re-run pear init anytime to reconfigure.

Your first session

Navigate to a project directory and start watching:

cd /path/to/your/project
pear watch

Pear opens an interactive TUI. Start coding — when you pause, Pear reviews your recent changes and teaches you something relevant. Type a question directly or use slash commands like /review and /help.

Verify your setup

Run the doctor command to check your config, API key, and provider connectivity:

pear doctor