langmix

Gradually immerses your Claude Code sessions in a language you're learning.

Code, commands, and file paths always stay in English.

Your language level persists across every repo you work in.

Install

npm install -g ./langmix   # or: npm publish and npm install -g langmix
langmix init --lang Spanish --difficulty beginner

Restart (or start a new) Claude Code session. Hooks are read at session start.

--difficulty sets your starting point and ramp speed:

| difficulty | starting level | levels up every | |--------------|----------------|------------------| | beginner | 1/10 | 10 turns | | intermediate | 3/10 | 7 turns | | advanced | 6/10 | 5 turns |

Commands

langmix status                  # current language, level, turn count
langmix pace <turns_per_level>  # change ramp speed
langmix level set <0-10>        # manually lock immersion at a level
langmix level unlock            # resume automatic progression
langmix blacklist add [dir]     # exclude a directory (and its subdirs); defaults to cwd
langmix blacklist remove [dir]  # stop excluding a directory; defaults to cwd
langmix blacklist list          # show excluded directories
langmix pause / resume          # toggle off/on without losing progress
langmix reset                   # reset turn count, keep language + difficulty
langmix uninstall               # remove the Claude Code hook