Make Claude Code speak plain language π£οΈ - Customizable verbosity levels and risk indicators
npm install kezaco



> Make Claude Code speak plain language π£οΈ
>
> Fais parler Claude Code simplement
---
You use Claude Code but don't always understand what it's doing? kezaco adds simple, non-technical explanations to every action, with visual risk indicators so you always know what's safe.
Tu utilises Claude Code mais tu comprends pas toujours ce qu'il fait ? kezaco ajoute des explications simples Γ chaque action, avec des indicateurs de risque visuels pour toujours savoir ce qui est safe.
| Without kezaco β | With kezaco β |
|---|---|
`` | ` |
`bashInstall with npx (recommended)
npx kezaco install
That's it! Claude Code will now explain what it's doing in French by default.
English?
`bash
npx kezaco install --lang en
`ποΈ Verbosity Levels Β· Niveaux de VerbositΓ©
Choose how detailed you want explanations to be:
| Level | Description | Best for |
|-------|-------------|----------|
|
beginner | π Detailed with analogies, glossary, and tips | Learning & non-technical users |
| normal | π Simple explanations with "Why?" | Default - most users |
| minimal | β‘ Ultra-concise: emoji + 5 words max | Experienced users |
| tech | π» Technical language, optional rationale | Developers |$3
π beginner - Detailed with analogies
`
π’ I'm reading the package.json file (it's like your project's
ID card - it lists all installed tools, similar to an ingredient
list on a food package).
β Why? To understand what tools are already available.
β Best practice: Always check this file before adding new tools!
`
π normal - Simple explanations (default)
`
π’ I'm reading the package.json file to check dependencies.
β Why? To avoid installing duplicates.
`
β‘ minimal - Ultra-concise
`
π’ Reading package.json
`
π» tech - Technical language
`
π’ Parsing package.json to analyze the dependency tree.
`$3
`bash
At installation
npx kezaco install --level beginnerOr anytime after
kezaco level tech
`π¦ Risk Indicators Β· Indicateurs de Risque
Every action starts with a visual risk indicator:
| Indicator | Level | Description | Exemples |
|:---------:|-------|-------------|----------|
| π’ | Safe | Reversible, no impact | Read, create, search |
| π‘ | Caution | Modifies state - verify first | Edit, install, configure |
| π΄ | Danger | Irreversible or sensitive | Delete, push, deploy |
Classification details
π’ Safe Actions:
- Reading files (cat, head, tail, grep)
- Creating new files
- Searching/exploring codebase
- Running read-only commands (ls, pwd, git status)
π‘ Caution Actions:
- Modifying existing files
- Installing packages (npm install, pip install)
- Changing configuration
- Git operations (add, commit)
π΄ Danger Actions:
- Deleting files or directories
- Git push (especially to main/master)
- Running destructive commands (rm -rf)
- Database migrations
- Production deployments
π Commands Reference
| Command | Description |
|---------|-------------|
|
kezaco install | Enable explanations (french, normal by default) |
| kezaco install --lang en | Enable in english |
| kezaco install --level beginner | Enable with beginner verbosity |
| kezaco level | Change verbosity level |
| kezaco status | Show current configuration |
| kezaco uninstall | Disable and clean up |
| kezaco --help | Show help |$3
`bash
All options combined
npx kezaco install --lang en --level techShort flags
npx kezaco install -l en -L beginner
`| Option | Short | Values |
|--------|-------|--------|
|
--lang | -l | fr (default), en |
| --level | -L | beginner, normal (default), minimal, tech |π§ How it Works
kezaco adds instructions to your
~/.claude/CLAUDE.md file (Claude Code's global configuration). That's it - nothing else is modified, no data is collected.`
~/.claude/CLAUDE.md
βββ
βββ
βββ
βββ [Instructions for Claude Code]
βββ
`β FAQ
Does kezaco slow down Claude Code?
No. kezaco only adds text instructions to Claude Code's config file. It doesn't run any code during Claude Code's operation.
Can I use kezaco with other CLAUDE.md content?
Yes! kezaco only modifies its own block (between
and ). Any other content in your CLAUDE.md is preserved.
What happens if I upgrade from v1?
Your language setting is preserved. The new level feature is added with default (normal).
Can I add my own language?
Contributions welcome! Add templates in
lib/templates/[lang]/ and submit a PR.π§ͺ Testing
Quick validation after installation:
`bash
Check status
kezaco statusShould show:
β
kezaco is active
π Language: en
π Level: normal
`
Full test suite
`bash
Fresh install
kezaco uninstall 2>/dev/null
kezaco install --lang en --level beginner
kezaco statusChange level
kezaco level tech
kezaco statusError handling
kezaco install --level invalid # Should show errorCleanup
kezaco uninstall
kezaco status # Should show not installed
`π€ Contributing
PRs welcome! Ideas for contributions:
- π New languages - Add templates in
lib/templates/[lang]/`MIT - Use it however you want!
---
Made with β€οΈ for humans learning to code with AI
Fait avec β€οΈ pour les humains qui apprennent Γ coder avec l'IA