naming-gen

# Naming Gen You have a variable called "data2" and a function called "processStuff". This tool analyzes your code and suggests better names. Clear, descriptive names that tell you what things actually do. Because naming is hard and you shouldn't have to suffer. **One command. Zero config. Just works.** ## Quick Start ```bash npx ai-naming ./src/utils.ts ``` ## What It Does - Analyzes variable and function names in your code - Suggests clearer, more descriptive alternatives - Identifies vague names like "temp", "data", "result" - Respects your project's naming conventions - Shows context for why each suggestion is better ## Usage Examples ```bash # Analyze a single file npx ai-naming ./src/processor.ts # Analyze all files in a directory npx ai-naming ./src/ # Only flag the worst offenders npx ai-naming ./src --threshold 3 # Output suggestions as a checklist npx ai-naming ./src --format checklist ``` ## Best Practices - **Fix the vague ones first** - "data", "temp", "result" are the worst offenders - **Consider the scope** - Short names are fine for tiny scopes. Long names for wide scopes. - **Be consistent** - If you call it "user" somewhere, don't call it "customer" elsewhere - **Don't over-abbreviate** - "usr" doesn't save enough characters to justify the confusion ## When to Use This - Reviewing code before a PR - Refactoring legacy code with cryptic variable names - Learning to write more readable code - Code review prep when you know your names are lazy ## Part of the LXGIC Dev Toolkit This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work. **Find more:** - GitHub: https://github.com/LXGIC-Studios - Twitter: https://x.com/lxgicstudios - Substack: https://lxgicstudios.substack.com - Website: https://lxgicstudios.com ## Requirements No install needed. Just run with npx. Node.js 18+ recommended. ```bash npx ai-naming --help ``` ## How It Works The tool parses your source code, identifies all variable and function names, analyzes what each one actually does by looking at how it's used, then suggests names that better describe the purpose and content. ## License MIT. Free forever. Use it however you want.