explaingit

secondfry/claude-code-self-learn

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

TLDR

A Claude Code plugin that reads finished session transcripts and automatically extracts reusable facts and skills into memory, with no cost to live conversations.

Mindmap

mindmap
  root((repo))
    What it does
      Reads finished transcripts
      Extracts facts and skills
      Runs out of band
    Tech stack
      Python
      Node
      Claude Code plugin
    Use cases
      Auto memory capture
      Skill reuse
      Background learning
    Audience
      Developers
      Claude Code users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically capture lessons from past Claude Code sessions into persistent memory.

USE CASE 2

Turn a proven technique from one session into a reusable skill file for future sessions.

USE CASE 3

Run background learning without spending any interactive conversation time.

What is it built with?

PythonNode.jsClaude Code

How does it compare?

secondfry/claude-code-self-learn0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node and Python 3 available on PATH for the hooks and dispatcher.

In plain English

self-learn is a plugin for Claude Code, the command line AI coding assistant, that adds a self-improving memory loop. It is a Python project with no GitHub stars yet, built by developer secondfry. The idea is based on an existing project called Hermes Agent, adapted with lessons from two other Claude Code plugins, claude-reflect and claude-self-improving-skills. Instead of learning during a live conversation, self-learn reads the transcript files that Claude Code already saves to disk after a session ends, and pulls useful information out of them once the session goes idle. Two kinds of information get extracted. Facts, meaning things worth remembering about a project or a user's preferences, are written into Claude Code's built in memory format, either to a global folder or to a folder specific to that project. Skills, meaning reusable techniques that worked well in a session, get written as SKILL.md files that Claude Code can reuse later. The extraction work happens on a schedule, roughly every thirty minutes, checked by a background dispatcher script. It waits until a transcript file has been untouched for a set number of minutes before treating the session as finished, so it never reads a conversation that is still in progress. It also tracks how much new activity has happened since the last check, so it only kicks off the extraction agents when there is enough new material. Installation is done from the command line using Claude Code's own plugin commands, and after installing, restarting a Claude Code session lets a background scheduler register itself automatically depending on the operating system: launchd on macOS, a systemd timer on Linux, or a Scheduled Task on Windows. The project requires Node and Python 3 to be available. The README highlights that no separate always-on server is needed and nothing gets added to the live conversation, since everything runs after the fact using files Claude Code already writes.

Copy-paste prompts

Prompt 1
Help me install the self-learn Claude Code plugin from secondfry/claude-code-self-learn.
Prompt 2
Explain how self-learn's idle-gate and watermark counter decide when to process a transcript.
Prompt 3
Walk me through the difference between self-learn's fact-extractor and skill-distiller subagents.
Prompt 4
Show me how self-learn's background scheduler registers itself on macOS, Linux, and Windows.

Frequently asked questions

What is claude-code-self-learn?

A Claude Code plugin that reads finished session transcripts and automatically extracts reusable facts and skills into memory, with no cost to live conversations.

What language is claude-code-self-learn written in?

Mainly Python. The stack also includes Python, Node.js, Claude Code.

How hard is claude-code-self-learn to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-code-self-learn for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.