Initial code

README.md

@@ -0,0 +1,153 @@
+# Prompter
+
+Code smarter with AI—no more messy copy-pasting. Prompter structures your prompts and applies AI changes seamlessly, streamlining your coding workflow.
+
+## Why Prompter?
+
+- **Too much bloat in your repo?** Stop zipping everything—send only the files that matter.
+- **LLM underperforming?** Cut the noise for sharper, more accurate responses.
+- **Better AI coding?** Select just the right context to optimize results.
+
+Prompter empowers you to work efficiently with AI, reducing token waste and improving clarity.
+
+## Features
+
+- **Advanced File Selection & Token Estimation**
+  Precisely filter files and estimate token usage instantly for optimized, cost-effective prompts.
+
+- **Optimized XML Prompt**
+  Structured file trees, CodeMaps, content, and instructions in XML for maximum LLM clarity.
+
+- **Structured XML Diffs**
+  Converts LLM-generated XML edits into precise, reviewable diffs—works at any file size.
+
+- **Codemap Extraction**
+  Scans files locally to extract classes, functions, and references, minimizing tokens and hallucinations. Auto-detects referenced types.
+
+- **Mac-Native Performance**
+  Built for macOS with native speed and responsiveness—because performance matters.
+
+- **Clipboard Integration**
+  Copy structured prompts into any AI chat app—your data stays local, no external API needed.
+
+- **Works with Any Model**
+  Compatible with OpenAI, Anthropic, DeepSeek, Gemini, Azure, OpenRouter, and local models—private and offline when you need it.
+
+- **Privacy First**
+  Local models, offline scanning, and direct clipboard use—no intermediaries required.
+
+## Installation
+
+*(Note: Installation steps are assumed based on the VS Code context from other files. Adjust as needed.)*
+1. Clone the repository:
+   ```bash
+   git clone <repository-url>
+   ```
+2. Open the project in VS Code.
+3. Install dependencies:
+   ```bash
+   npm install
+   ```
+4. Build the extension:
+   ```bash
+   npm run compile
+   ```
+5. Press `F5` in VS Code to launch the extension in a development window.
+
+## Usage
+
+1. Open your project in VS Code.
+2. Use the Prompter interface to select files and estimate tokens.
+3. Generate a structured XML prompt via the clipboard.
+4. Paste into your preferred AI model (e.g., ChatGPT, Claude, or a local LLM).
+5. Apply the returned XML diffs directly through Prompter for seamless integration.
+
+## Contributing
+
+We welcome contributions! To get started:
+1. Fork the repository.
+2. Create a feature branch: `git checkout -b my-feature`.
+3. Commit your changes: `git commit -m "Add my feature"`.
+4. Push to your branch: `git push origin my-feature`.
+5. Open a pull request.
+
+See `vsc-extension-quickstart.md` for development setup and testing details.
+
+---
+Built with ❤️ by the Prompter team.
+
+Code smarter with AI—no more messy copy-pasting. Prompter structures your prompts and applies AI changes seamlessly, streamlining your coding workflow.
+
+## Why Prompter?
+
+- **Too much bloat in your repo?** Stop zipping everything—send only the files that matter.
+- **LLM underperforming?** Cut the noise for sharper, more accurate responses.
+- **Better AI coding?** Select just the right context to optimize results.
+
+Prompter empowers you to work efficiently with AI, reducing token waste and improving clarity.
+
+## Features
+
+- **Advanced File Selection & Token Estimation**
+  Precisely filter files and estimate token usage instantly for optimized, cost-effective prompts.
+
+- **Optimized XML Prompt**
+  Structured file trees, CodeMaps, content, and instructions in XML for maximum LLM clarity.
+
+- **Structured XML Diffs**
+  Converts LLM-generated XML edits into precise, reviewable diffs—works at any file size.
+
+- **Codemap Extraction**
+  Scans files locally to extract classes, functions, and references, minimizing tokens and hallucinations. Auto-detects referenced types.
+
+- **Mac-Native Performance**
+  Built for macOS with native speed and responsiveness—because performance matters.
+
+- **Clipboard Integration**
+  Copy structured prompts into any AI chat app—your data stays local, no external API needed.
+
+- **Works with Any Model**
+  Compatible with OpenAI, Anthropic, DeepSeek, Gemini, Azure, OpenRouter, and local models—private and offline when you need it.
+
+- **Privacy First**
+  Local models, offline scanning, and direct clipboard use—no intermediaries required.
+
+## Installation
+
+*(Note: Installation steps are assumed based on the VS Code context from other files. Adjust as needed.)*
+1. Clone the repository:
+   ```bash
+   git clone <repository-url>
+   ```
+2. Open the project in VS Code.
+3. Install dependencies:
+   ```bash
+   npm install
+   ```
+4. Build the extension:
+   ```bash
+   npm run compile
+   ```
+5. Press `F5` in VS Code to launch the extension in a development window.
+
+## Usage
+
+1. Open your project in VS Code.
+2. Use the Prompter interface to select files and estimate tokens.
+3. Generate a structured XML prompt via the clipboard.
+4. Paste into your preferred AI model (e.g., ChatGPT, Claude, or a local LLM).
+5. Apply the returned XML diffs directly through Prompter for seamless integration.
+
+## Contributing
+
+We welcome contributions! To get started:
+1. Fork the repository.
+2. Create a feature branch: `git checkout -b my-feature`.
+3. Commit your changes: `git commit -m "Add my feature"`.
+4. Push to your branch: `git push origin my-feature`.
+5. Open a pull request.
+
+See `vsc-extension-quickstart.md` for development setup and testing details.
+
+---
+Built with ❤️ by the Prompter team.