Your machine briefs you —
not the other way around.

Tool Teacher is a local-first inventory & early-warning system for your tool park. It scans what you actually have (Homebrew, npm, apps, native installers), tells you which tools you've forgotten, teaches you the ones you keep — and puts breaking changes first, always.

✓ read-only + local-first ? honest unknowns ● no telemetry

One scan, honest answers

$ tt 270 tools · last scan 1h ago · 61 releases unread ✖ 2 breaking changes waiting in your digest. next: tt digest

Bare tt is a guided status: one urgent fact, one next command. The tool teaches its own operation.

Breaking beats feature. Always.

$ tt digest briefing · 3 breaking, 9 behavior, 18 feature ✖ BREAKING just 1.55.1 → 1.57.0 Justfiles with duplicate groups now error. $ brew upgrade just + FEATURE codex 0.145.0 audio I/O, agents V2 40 fixes folded away.

Release notes, read for you by your own AI CLI — your keys, your machine. No AI installed? Facts degrade honestly, never wait.

It doesn't just watch your tools. It teaches them.

$ tt teach ripgrep teach · ripgrep WHAT IT IS: line-oriented search, respects .gitignore, faster than grep. $ rg -uuu 'secret' . # disable all smart filtering, like classic grep $ git log --oneline | rg -w 'fix' # rg greps any command's output NOT USING YET: RIPGREP_CONFIG_PATH — your default flags, applied everywhere. sources: man · tldr · release notes · your inventory

Lessons are generated from real sources (man, tldr, release notes) and personalized to your inventory — recipes combine tools you actually have. Cached locally, served in the terminal, the dashboard, and to your coding agent via MCP.

Six surfaces, one knowledge

tt scanRead-only inventory of brew, npm, apps & native installers — dust states, forgotten-tool candidates, honest unknowns.

tt digestThe prioritized briefing. Breaking > behavior > feature > fix — with copy-paste fix commands. --plan prints just the commands.

tt teachThe Lesson: what a tool is, why you have it, recipes personalized to your park.

tt mcpYour coding agent asks: what's installed, what changed since yesterday, teach me this tool.

tt serveLocal dashboard — card grid, categories, digest inbox, tool detail with lessons.

tt reportThe shareable snapshot: "270 tools · 23 forgotten · 61 unread releases". Generated locally, shared by you.

Rules this product will not break

1Read-only. It never installs, updates, or removes anything. It tells you why and whether you'd want to — you run the command.

2Local & private. Nothing leaves your machine. AI runs through your own CLI and keys. No accounts, no telemetry.

3Breaking beats feature. In every sort, digest, card, and agent answer.

4Every insight is pushable. Terminal, MCP, and dashboard are equal citizens.