
learn-from-lessons
A skill/tool that lets your coding agents learn from your corrections — Claude Code, Codex, opencode, MCP
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up learn-from-lessons (git-clone project) into my current project. Found on https://claudeers.com/learn-from-lessons Repo: https://github.com/assassin808/learn-from-lessons Homepage/docs: — Detected install method: git-clone → git clone https://github.com/assassin808/learn-from-lessons Category: mcp-servers. Platforms: cli, api. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/assassin808/learn-from-lessons
// compatibility
| Platforms | cli, api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Python |
Every time you correct your coding agent, it should learn. This makes it.
Install •
Usage •
How it works •
Guide •
Contributing
You tell Claude Code "don't push yet", "I asked why, not to change it", "that number isn't from the table" — and next session it does it again. Learn from Lessons reads the transcripts already on your machine (Claude Code, Codex, opencode), finds the moments you corrected the agent, and turns them into short lessons with the exact quote they came from. Your agents load them next time.
Install
pipx install git+https://github.com/assassin808/learn-from-lessons
Python 3.9+, no other dependencies. Everything runs locally.
Usage
lessons scan # what's on this machine: sessions, corrections
lessons dream # turn corrections into lessons (uses your own claude / codex CLI)
lessons view # browse them: list, graph, evidence
lessons inject --target CLAUDE.md --apply # let your agent load them
Writing a paper doesn't need your git-push lessons: filter by scenario.
lessons index --scenario writing-paper
lessons search "about to launch the eval runs" --context "$(git log -1)"
Also ships as a Claude Code skill, an AGENTS.md block for Codex and
opencode, and an MCP server (lessons mcp).
How it works
A lesson is a small prediction: when this situation comes up, doing X avoids a correction. Lessons sit at three levels — a principle ("ask where the person holds the decision"), the rules under it ("push only after an explicit go-ahead"), and narrow cases ("in this repo, Overleaf is the source of truth"). Each one cites the conversations it came from and is marked verified once it has been seen twice.

The design follows Anthropic's The Components of Agent Memory: transcripts are the ground truth, lessons are checked against them, and only a small index is loaded by default. Details: docs/GUIDE.md · docs/LESSON_FORMAT.md.
Does it work?
On 47 new situations — different projects from the ones the lessons came from — an agent followed the person's
rule 85% of the time without lessons and 98–100% with them, without becoming over-cautious elsewhere.
One person's data so far; the test is in eval/.
Contributing
Looking for collaborators: readers for more agents (Cursor, Aider, Gemini CLI, Cline), people willing to run the evaluation on their own history, and researchers interested in agent memory. Open an issue or a discussion. See CONTRIBUTING.md.
Citation
@software{learn_from_lessons_2026,
author = {{learn-from-lessons contributors}},
title = {Learn from Lessons: Turning Coding-Agent Corrections into Evidence-Linked Lessons},
year = {2026},
url = {https://github.com/assassin808/learn-from-lessons}
}
Built on ideas from Anthropic, The Components of Agent Memory (2026). MIT License.
// faq
What is learn-from-lessons?
A skill/tool that lets your coding agents learn from your corrections — Claude Code, Codex, opencode, MCP. It is open-source on GitHub.
Is learn-from-lessons free to use?
learn-from-lessons is open-source under the MIT license, so it is free to use.
What category does learn-from-lessons belong to?
learn-from-lessons is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/learn-from-lessons)
// retro hit counter
[](https://claudeers.com/learn-from-lessons)
// reviews
// guestbook
// related in MCP Servers
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman
An open-source AI agent that brings the power of Gemini directly into your terminal.