naming-gen

name	naming-gen
description	Suggest better variable and function names in your code. Use when improving code readability.

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

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

# 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.

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.