dvcrn Refactor Assistant
Code review yourself before anyone else does. Point this at a file and get specific refactoring suggestions with diffs.
One command. Zero config. Just works.
Quick Start
npx ai-refactor src/utils.ts
What It Does
- Analyzes code for improvement opportunities
- Shows colored diffs for suggested changes
- Focuses on readability and patterns
- Can apply changes automatically
Usage Examples
# See suggestions
npx ai-refactor src/utils.ts
# Apply changes directly
npx ai-refactor src/utils.ts --apply
# Focus on specific area
npx ai-refactor src/api.ts --focus "error handling"
Best Practices
- Review before applying - verify suggestions make sense
- Commit first - have a clean state to diff against
- Focus on one thing - don't refactor everything at once
- Run tests after - make sure nothing broke
When to Use This
- Code review prep
- Cleaning up old code
- Learning better patterns
- Technical debt sprints
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://lxgic.dev
Requirements
No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.
npx ai-refactor --help
How It Works
Reads your file, sends it to GPT-4o-mini for analysis, and shows refactoring suggestions as diffs. Looks at readability, duplication, modern patterns, performance, and type safety.
License
MIT. Free forever. Use it however you want.