komi-learn

komi-learn is an innovative tool designed for enhancing coding agents through continuous memory and self-improvement. It seamlessly learns how users work, automatically recalling relevant information without the need for commands or manual intervention. This functionality integrates with Claude Code and Codex, making it a valuable addition to AI coding workflows.

Key Features:

• Automatic Learning: komi-learn observes coding sessions and distills important lessons in the background, focusing on user-specific styles, preferred stacks, and effective corrections.
• Effortless Recall: Relevant insights are automatically loaded at the beginning of each session, allowing for a smoother and more efficient coding experience without requiring manual commands.
• Background Distillation: After sessions, the tool analyzes transcripts to extract valuable lessons, ensuring continual improvement over time.
• Curated Community Pool: Users can choose to contribute to a shared repository of learned lessons, fostering a collaborative environment where agents benefit from insights gained by others.

How It Works:

1. Recall: Lessons relevant to the current context are loaded at the start of each session.
2. Distill: The tool processes session transcripts to identify and record enduring insights.
3. Curate: Lessons are continually refined over time by merging similar insights and archiving outdated ones.
4. Share: Users have the option to contribute approved lessons to a community pool, enriching the knowledge base for all users.

Example Commands:

komi-learn doctor      # Checks installation and identifies needed fixes
komi-learn status      # Displays configuration and learned data summary
komi-learn config      # Allows configuration adjustments
komi-learn sync        # Updates community lessons
komi-learn forget <x>  # Erases specific lessons

Offline Demonstration:

Users can explore the functionality without a full setup or API key by running:

python examples/demo_loop.py

This example showcases two sessions where the agent learns from corrections and recalls information in subsequent interactions.

Requirements:

• Compatible with Python 3.10+
• Integrates with either Claude Code or Codex
• Includes necessary components for the learning and recall processes

Komi-learn is a forward-looking solution for those who wish to enhance their coding with intelligent, self-improving agents. Feedback and contributions from users are encouraged to further refine the tool.