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

Homebrew

curl

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