VSCode Aider (Sengoku)

Launches an Aider CLI session directly from VSCode's command palette via the 'Aider: Open' command, establishing a bidirectional bridge between the editor and Aider's AI-driven code modification engine. The extension spawns Aider as a subprocess, passing the current workspace context and maintaining file synchronization between VSCode's editor state and Aider's internal file tracking. This integration eliminates context-switching by embedding Aider's full capabilities within the editor's native command interface.

Enables in-place code refactoring by right-clicking on a code selection in the editor, which passes the selected text and surrounding file context to Aider's AI engine with a refactoring intent. The extension captures the selection range, file path, and project context, then invokes Aider with refactoring-specific prompts. Modified code is returned and applied back to the editor with change tracking, allowing developers to review and accept/reject modifications before committing.

Allows developers to assign custom keyboard shortcuts to Aider commands (e.g., 'Aider: Open', 'Aider: Voice Command') via VSCode's keybindings configuration interface. Developers can override default keybinds or create new ones for frequently-used commands, enabling rapid access without command palette invocation. Keybindings are configured through VSCode's standard keyboard shortcuts UI (File > Preferences > Keyboard Shortcuts) and stored in the user's keybindings.json file.

Provides extension settings for configuring OpenAI and Anthropic API keys, which are stored in VSCode's settings storage and used to authenticate requests to AI model APIs. Developers configure API keys through VSCode's settings UI (File > Preferences > Settings > Extensions > Aider), and the extension passes them to Aider CLI via environment variables or command-line arguments. The extension does not implement its own API calls; instead, it delegates to Aider CLI, which handles authentication.

Integrates with VSCode's diagnostics system to enable right-click error fixing on code errors, linting warnings, or type errors. When a developer right-clicks on a diagnostic (red squiggle), the extension captures the error message, error location, surrounding code context, and file path, then sends this to Aider with a fix-intent prompt. Aider's AI engine analyzes the error and suggests or applies fixes, which are returned to the editor for review and application.

Provides right-click context menu integration on files and folders in VSCode's file explorer, enabling developers to add or ignore files from Aider's context without manually managing Aider's file list. The extension translates file explorer selections into Aider CLI commands (e.g., 'aider add <file>' or 'aider ignore <file>'), updating Aider's internal file tracking and ensuring subsequent AI operations only consider the selected files. This allows developers to scope AI operations to specific parts of the codebase.

Provides a 'Aider: Select Model' command in the command palette that displays available AI models (GPT-4, Claude, and custom models) and allows developers to switch between them without restarting Aider or the extension. The extension maintains model selection state and passes the selected model to Aider CLI invocations via command-line arguments. Developers can also set a default model in extension settings, which is used for all subsequent Aider sessions unless explicitly overridden.

Enables voice-based prompting for Aider operations via a 'Aider: Voice Command' command, triggered by a customizable keybind (e.g., Ctrl+Shift+V). When activated, the extension captures audio input from the system microphone, converts it to text using OpenAI's speech-to-text API, and sends the transcribed text as a prompt to Aider. This allows developers to issue AI-assisted code modifications using natural speech rather than typing, useful for hands-free or rapid-fire prompting.

Provides a 'Aider: Generate README.md' command that analyzes the current project's codebase and automatically generates or updates a README.md file using Aider's AI engine. The extension passes project context (file structure, key files, existing documentation) to Aider with a documentation-generation prompt, then creates or overwrites the README.md file with the generated content. This automates documentation creation for new projects or updates existing documentation when code changes.

Maintains automatic synchronization of file state between VSCode's editor and Aider's internal file tracking, ensuring that changes made in the editor are reflected in Aider's context and vice versa. The extension monitors VSCode's file change events (saves, deletes, renames) and propagates them to Aider, while also pulling changes from Aider back into the editor. This two-way sync prevents state divergence and ensures AI operations always work with current code.

Displays a clickable status bar item in VSCode's status bar that provides quick access to Aider commands and settings without requiring command palette invocation. Clicking the status bar item opens a menu with options to open Aider, select a model, access settings, and view current session status. This provides a persistent, always-visible entry point for Aider operations, complementing the command palette interface.

Supports integration of custom AI models beyond the built-in GPT-4 and Claude options, allowing developers to add and use their own models with Aider. The extension provides a mechanism to register custom models and pass them to Aider CLI via configuration, enabling use of local models, fine-tuned models, or proprietary APIs. However, the specific implementation details (API format, configuration method, supported model types) are undocumented.