Workflows

Pear has four core workflows. Each one reads your codebase context (git diff, file tree, recent changes) and responds with teaching intent.

Watch

pear watch

The flagship mode. Pear opens an interactive TUI, watches your files with fsnotify, and monitors your git diff. When you pause — while your agent thinks, after a save, between tasks — Pear reviews what changed and teaches you something relevant.

Watch mode is designed to run alongside your editor and AI coding tools. It never interrupts; it waits for natural pauses in your workflow.

Ask

pear ask "what does this middleware do?"

Ask a question about your codebase. Pear reads your current context and answers with teaching intent — it explains concepts, not just facts. Use @file to include specific files as context.

Review

pear review

Review your uncommitted changes. Pear analyzes your current diff and gives feedback focused on learning — not just “this is wrong” but “here's why this pattern matters and what to watch for.”

Teach

pear teach              # Pear picks a topic
pear teach "goroutines" # You pick a topic

Deep-dive teaching grounded in your actual code. Without a topic, Pear picks one based on your recent changes. With a topic, it teaches that concept using examples from your codebase.