repo-whisperer 🪄

Instantly generate perfect AI Context Instructions by analyzing your repository DNA.

AI coding assistants (Cursor, GitHub Copilot, Claude) are incredible, but they drop into your codebase completely blind to your team's unique architectural and stylistic conventions. They hallucinate imports, mix React paradigms, and output code that doesn't match your vibe.

repo-whisperer is a blazing fast CLI that deeply analyzes your package.json, tsconfig.json, and folder structure to instantly generate a highly assertive .cursorrules (or AI_INSTRUCTIONS.md) file tailored exactly to your stack.

Installation & Usage

You can run it instantly inside any project directory:

npx @dinakars777/repo-whisperer

(Or install it globally):

npm install -g @dinakars777/repo-whisperer
cd my-nextjs-project
whisper

Options

• -o, --output <filename>: The filename to output the rules to. Defaults to .cursorrules. (e.g., whisper --output AI_INSTRUCTIONS.md)

Setup

You need a standard OpenAI API Key to synthesize the rules. You will be prompted for it if OPENAI_API_KEY is not set in your environment.

How It Works

1. whisper scans your dependency tree to identify frameworks (React, Next.js, Vue, NestJS), testing tools (Jest, Playwright), and styling libraries (Tailwind, Styled Components).
2. It analyzes tsconfig.json and directory structure (App Router vs Pages router, src/ presence, monorepos).
3. It feeds this "Repository DNA" to gpt-4o to synthesize a strict, opinionated instruction manual.
4. It safely writes the rules to your repository.

Every AI agent that touches your code from this point forward will read this file and instantly adopt your project's soul.

License

MIT