We built CodeYam Memory because Claude Code kept repeating the same mistakes and our claude.md files got stale. CodeYam Memory uses a background agent to review your coding session transcripts, identifies confusion patterns, and generates targeted rules with proper scoping. This is a small first step towards our vision of exploring the ideal AI-native development experience, packaged as a lightweight CLI that you can use wherever you use Claude Code.
Hey PH community! I’m Nadia, one of the makers. Happy to answer anything.
We built CodeYam Memory because Claude Code kept making the same mistakes on our codebase. Our claude [dot] md files quickly got stale and maintaining by hand or with Claude wasn’t sufficient.
While digging into this we found that Claude has a native rules system that allowed us to target specific parts of our repo with path matching. This was ideal for our use case but trying to manage these rules by hand was already not working and would be even harder with more granular, targeted rules.
CodeYam Memory uses a background agent to review your coding session transcripts, identifies confusion patterns, and generates targeted rules with proper scoping. You review and approve everything. Dashboard for auditing, a background-agent review process so nothing goes stale as code changes, tracking of everything lives in a simple file in git.
How to Get Started:
Install:
npm install -g @codeyam/codeyam-cli@latest
Then from your project root run:
codeyam
This will launch a dashboard with further instructions for initializing CodeYam Memory.
Free, runs locally, no login required, and language agnostic. Would love feedback.
Some context on what “rules” are for people who haven’t seen them: Claude Code has a built-in system for structured context beyond claude.md files. Rules support path matching (apply context only to specific files/directories), scoped organization, and structured formatting.
We have been running CodeYam Memory on our own repo for the past few weeks. The main difference we see is fewer repeated mistakes and less manual context maintenance. It’s still early, but it has meaningfully improved how we work with Claude Code.
If discussion gets too long for HN threads, we also have a Discord for questions and feedback: https://discord.gg/eFPUs7CeFw