memcode docs
CLI

MEMCODE.md

Give memcode rules to follow on every task, in a file it reads each turn.

MEMCODE.md is a file of rules you want memcode to follow every time. Put it at your repo root and memcode reads it on every task.

What to put in it

Anything memcode should always know or do in this repo. For example:

  • run make test before proposing a commit
  • this repo uses tabs, not spaces
  • prefer the existing HTTP client over adding a new one
  • never touch files under vendor/

Keep it short and specific. It loads on every turn, so treat it like a note to a new teammate, not a wiki.

Where memcode looks

memcode reads the first file it finds, and a file in your project beats a user-wide one:

ScopeFiles, in order
Project./MEMCODE.md, ./CLAUDE.md, ./AGENTS.md
User-wide~/.memcode/MEMCODE.md, ~/.claude/CLAUDE.md

If you already keep instructions in CLAUDE.md or AGENTS.md, they work as they are.

Rules vs. skills

Use MEMCODE.md for rules that always apply. Use a skill for a procedure that only comes up sometimes, like a deploy or a specific migration.

On this page