CodeSlice AI

English · Français

English

CodeSlice AI is a project-aware AI coding assistant for Visual Studio Code. Ask questions, review code, prepare controlled multi-file edits, and use inline completion without leaving your editor.

Bring your own API keys and choose from OpenRouter, NVIDIA NIM, OpenAI, Anthropic, xAI, Google Gemini, Mistral AI, Groq, Together AI, and Fireworks AI. xAI uses Grok 4.5 by default.

Requires Visual Studio Code 1.125.0 or later. You can also connect a self-hosted server with an OpenAI-compatible API.

Quick start

1. Open CodeSlice AI: Settings and choose a model.
2. Save an API key if your provider requires one. VS Code stores it securely.
3. Open the CodeSlice AI chat or select code and run a command from the Command Palette or context menu.

CodeSlice AI does not include AI models or API credits. Any usage costs depend on the provider and model you select.

Preview

Features

• multi-turn chat from the Secondary Side Bar (Ctrl+Shift+I);
• questions about a selection, the active file, or several workspace files;
• selection explanation and controlled replacement;
• multi-file edit proposals with diff previews before anything is written;
• smart project context built from symbols, imports, definitions, and related files;
• screenshot attachments for image-capable models;
• commit message generation from staged Git changes;
• optional Codestral FIM inline completion;
• per-conversation model selection and optional model orchestration;
• a bounded local-first harness with cumulative budgets, read-only tools and a scoped execution contract for code edits;
• custom models, per-model API keys, and configurable fallback orders;
• bounded model fallback that skips models sharing rejected credentials and stops request errors that another model cannot fix;
• a single settings page with drag-and-drop ordering of the models used for each task type;
• retry for failed or cancelled responses;
• encrypted API key import and export.

Controlled edits

With agent mode disabled (codeslice-ai.agentModeEnabled: false), CodeSlice AI:

1. builds a read-only working context;
2. asks the model for a structured proposal;
3. shows the affected files and diffs;
4. waits for your confirmation before writing;
5. can run an approved validation command after confirmation.

Edits use a scoped execution contract: only the attached files and the workspace context found for the request may be modified. The implementer may investigate with bounded read-only workspace, diagnostics, and Git tools, then returns a structured proposal or a concrete blocker. Local checks enforce the approved paths before the diff preview and again before apply. Extending the scope requires an explicit modal confirmation. A run is capped at 12 model calls, 20 read-only tool calls, 250k input tokens, and 48k output tokens by default.

Required contract files are loaded before implementation. If a blocked run discovers that additional files are necessary, CodeSlice AI shows the exact paths and asks before extending the contract. Repeated protocol failures stop when no new evidence has been collected.

There is no separate planning or review model call: the diff preview is the review step. Provider contracts, usage metrics, local routing, prompt structure, and backward-compatible one-shot wrappers are always active.

Agent mode is a separate experimental setting, enabled by default (codeslice-ai.agentModeEnabled; set it to false to keep manual apply and validation). It is a restricted setting, so a workspace cannot turn it on or off for you in an untrusted folder. An edit proposal can be authorized for automatic application, validation and correction with an explicit list of files and commands and a fixed budget. New files or commands outside that authorization require approval. Cancellation, conflicting workspace changes, exhausted budgets and lack of progress stop the run. Interrupted runs require an explicit resume and renewed authorization; existing user edits are never automatically rolled back. A command policy is not an operating-system sandbox: approved commands run with your local permissions.

Project instructions are resolved for each workspace and affected file, from root to parent directory: AGENTS.md, or CLAUDE.md only when AGENTS.md is absent at the same level. .codeslice/instructions.md remains an additional root instruction source. Nested instructions apply only within their scope. Explicit conflicting directives are reported before application; this check does not detect every semantic contradiction.

Model-proposed deletions, renames, paths outside the workspace, unsafe shell operators, and unsupported validation programs are rejected.

Privacy

CodeSlice AI collects no telemetry and sends no data to its developer. When you make a request, the instructions and selected context are sent directly to the AI provider you chose. This may include selected or attached code, bounded workspace context, relevant recent conversation history, and screenshots.

Two optional features make additional requests:

• model orchestration can contact Google Gemini or OpenAI to select a task profile and model;
• inline completion sends the code before and after the cursor to the Mistral Codestral FIM API.

API keys are stored in VS Code SecretStorage. Manual key export creates an AES-256-GCM encrypted .aikeys file protected by your passphrase.

The active provider and local-server endpoint are global settings: a repository cannot override their destination. Local endpoints may use HTTP only on loopback addresses; remote self-hosted endpoints must use HTTPS. Optional local gateway keys are accepted only for the endpoint they were configured for.

Settings, custom models, and conversations are stored locally by VS Code. Data sent to an AI provider is subject to that provider's own terms and retention policy. Review them before using CodeSlice AI with sensitive or confidential code.

The harness keeps at most 500 local numeric run metrics without prompts, code, or raw paths. The settings page can export or purge them. CodeSlice AI: Capture Latest Harness Fixture is a separate opt-in action that saves the latest full exchange to a JSON file you choose.

Project context

The default smart mode can include:

• the selection and its enclosing symbol;
• imports and likely related files;
• open files and a bounded project overview;
• definitions and consumers of important identifiers.

The context inspector shows the selected files, estimated token count, selection reasons, truncation, and sensitive-file exclusions before sending. Use selectionOnly to send only explicitly selected code.

Chat commands

Type / in chat to see the available commands. For /edit, the chat sends your instruction to the model after removing the command prefix.

• /new: start a new conversation;
• /model: choose the conversation model;
• /settings: open the settings page;
• /selection: attach the active selection;
• /file: attach the active file;
• /files: choose several files;
• /edit <instruction>: ask the chat to prepare a code edit for this turn.

The chat distinguishes answers, reviews, and edit requests. Instructions such as “do not modify anything” remain conversational and do not trigger an edit.

In a trusted local workspace, answers and reviews can investigate with bounded read-only tools, independently of agent mode. The model can search files, inspect symbols/references and diagnostics, discover workspace repositories and branches, inspect commit history, resolve refs and merge bases, compare explicit refs or a branch against its common ancestor, and read historical files. Branch names (including feature/#150-tracking-temps) and natural-language requests do not require a special SHA syntax. Reviews must establish the requested change scope and ask when the base is ambiguous; current workspace files provide supporting context and do not replace an unavailable diff. Git access is local, with no fetch, checkout, writes or shell commands. Multi-root requests require an explicit root/repository choice. Sensitive/excluded paths are omitted; paginated and incomplete evidence must be disclosed. Investigation shows progress and then the final answer, pins the model after its first successful result, and shares the configured cumulative harness budget, including routing/summary calls. Providers without native tools use the same bounded tools through a JSON text protocol. Without a trusted local workspace, chat retains the attached-context streaming path.

Main commands

Code-related shortcuts apply while the editor has focus.

Settings

CodeSlice AI: Settings opens one page holding every setting, grouped into models, model order by task, API keys, autocomplete, complex tasks, and advanced. The status bar item and Ctrl+Alt+A both lead to it.

Its main purpose is the model order per task type. Chat classifies each request as an answer, an implementation plan, a review, or a simple, logic, or large edit, then uses the first model of that type's list that has an API key and falls back to the next one on failure. Each list is a card you reorder by dragging a row or using the arrow buttons, with a badge showing which models are actually usable. Customize starts from the built-in order, and Restore built-in order reverts.

Fallback attempts share a two-minute deadline. Request errors that another model cannot fix stop immediately, while rejected or exhausted credentials skip the remaining models that use the same provider key.

Quick Settings remains available for keyboard-only navigation and covers the same options.

For a self-hosted server, choose Local server as the default provider in VS Code user settings. Set codeslice-ai.localBaseUrl to the server’s API base URL (for example, http://localhost:11434/v1) and codeslice-ai.localModel to the exact model name the server exposes. Add a gateway key only if the server requires one.

Codestral autocomplete

Inline completion uses codestral-latest through Mistral and remains independent from the active chat provider.

1. Configure a Mistral API key in the settings page, under autocomplete.
2. Run CodeSlice AI: Toggle Codestral Autocomplete.
3. Type in a text file and accept a suggestion with Tab.

Defaults

• provider: openrouter;
• OpenRouter model: qwen/qwen3-coder:free;
• temperature: 0.3;
• maximum output tokens: automatic for the selected model;
• workspace context: smart;
• response view: Markdown preview;
• streaming: enabled;
• model orchestration: disabled;
• Codestral autocomplete: disabled, balanced mode.

The settings page lets you change these values, manage keys and models, reorder the models used for each task type, and test the active API call.

Support

Use GitHub Issues to report a bug or suggest an improvement. Do not include API keys, personal data, private source code, or other sensitive information.

If CodeSlice AI saves you time, you can support its development on Ko-fi.

Français

CodeSlice AI est un assistant de développement IA pour Visual Studio Code qui utilise le contexte utile de votre projet. Posez des questions, relisez du code, préparez des modifications multi-fichiers contrôlées et utilisez l’autocomplétion sans quitter l’éditeur.

Utilisez vos propres clés API et choisissez parmi OpenRouter, NVIDIA NIM, OpenAI, Anthropic, xAI, Google Gemini, Mistral AI, Groq, Together AI et Fireworks AI. xAI utilise Grok 4.5 par défaut.

Visual Studio Code 1.125.0 ou une version ultérieure est requis. Vous pouvez aussi connecter un serveur auto-hébergé doté d’une API compatible OpenAI.

Démarrage rapide

1. Ouvrez CodeSlice AI : Paramètres, puis choisissez un modèle.
2. Enregistrez une clé API si votre fournisseur en exige une. VS Code la conserve de façon sécurisée.
3. Ouvrez le chat CodeSlice AI ou sélectionnez du code, puis lancez une commande depuis la palette ou le menu contextuel.

CodeSlice AI ne fournit pas de modèle ni de crédits API. Les éventuels coûts dépendent du fournisseur et du modèle choisis.

Aperçu

Fonctionnalités

• chat multi-tours dans la barre latérale secondaire (Ctrl+Shift+I) ;
• questions sur une sélection, le fichier actif ou plusieurs fichiers du workspace ;
• explication et remplacement contrôlé d’une sélection ;
• propositions de modifications multi-fichiers avec aperçu des différences avant toute écriture ;
• contexte projet intelligent construit à partir des symboles, imports, définitions et fichiers liés ;
• captures d’écran jointes aux modèles compatibles avec les images ;
• génération de message de commit depuis les changements Git indexés ;
• autocomplétion inline Codestral FIM optionnelle ;
• choix du modèle par conversation et orchestration optionnelle ;
• harnais borné et local-first avec budgets cumulés, outils en lecture seule et contrat d’exécution borné pour les modifications de code ;
• modèles personnalisés, clés par modèle et ordres de secours configurables ;
• modèles de secours bornés, avec arrêt sur les erreurs propres à la requête et omission des modèles partageant des identifiants refusés ;
• une page de paramètres unique, avec réordonnancement par glisser-déposer des modèles utilisés pour chaque type de tâche ;
• nouvel essai des réponses échouées ou annulées ;
• import et export chiffrés des clés API.

Modifications contrôlées

Lorsque le mode agent est désactivé (codeslice-ai.agentModeEnabled: false), CodeSlice AI :

1. construit un contexte de travail en lecture seule ;
2. demande au modèle une proposition structurée ;
3. affiche les fichiers concernés et les différences ;
4. attend votre validation avant toute écriture ;
5. peut lancer une commande de validation autorisée après confirmation.

Les modifications utilisent un contrat d’exécution borné : seuls les fichiers joints et le contexte workspace trouvé pour la demande peuvent être modifiés. L’implémenteur peut examiner le workspace, les diagnostics et Git avec des outils bornés en lecture seule, puis fournit une proposition structurée ou un blocage concret. Des contrôles locaux vérifient les chemins autorisés avant l’aperçu du diff puis avant l’application. Étendre le périmètre nécessite une confirmation modale explicite. Par défaut, une exécution est limitée à 12 appels modèle, 20 outils en lecture seule, 250k jetons d’entrée et 48k de sortie.

Les fichiers requis par le contrat sont chargés avant l’implémentation. Si une exécution bloquée découvre que d’autres fichiers sont nécessaires, CodeSlice AI affiche leurs chemins exacts et demande confirmation avant d’étendre le contrat. Les erreurs de protocole répétées s’arrêtent lorsqu’aucune nouvelle preuve n’a été collectée.

Il n’y a pas d’appel modèle séparé de planification ou de relecture : l’aperçu du diff est l’étape de relecture. Les contrats fournisseur, métriques d’usage, routage local, prompts structurés et wrappers one-shot rétrocompatibles sont toujours actifs.

Le mode agent, expérimental et activé par défaut (codeslice-ai.agentModeEnabled ; passez-le à false pour garder l’application et la validation manuelles), est un réglage restreint : un workspace non fiable ne peut pas le modifier. Une proposition peut être autorisée pour enchaîner application, validation et correction avec une liste explicite de fichiers et de commandes, dans un budget fixe. Tout fichier ou commande supplémentaire nécessite une nouvelle autorisation. Une annulation, un conflit avec le workspace, un plafond atteint ou l’absence de progrès arrête l’exécution. Après interruption, la reprise est explicite et renouvelle l’autorisation ; le travail préexistant n’est jamais annulé automatiquement. La politique de commandes n’est pas une sandbox système : les commandes approuvées s’exécutent avec vos permissions locales.

Les instructions sont résolues pour chaque workspace et fichier concerné, de la racine vers son dossier parent : AGENTS.md, ou CLAUDE.md uniquement en l’absence d’AGENTS.md au même niveau. .codeslice/instructions.md reste un complément à la racine. Les instructions imbriquées ne s’appliquent qu’à leur périmètre. Les directives explicitement contradictoires sont signalées avant application ; ce contrôle ne détecte pas toutes les contradictions sémantiques.

Les suppressions, renommages, chemins hors workspace, opérateurs shell dangereux et programmes de validation non autorisés proposés par le modèle sont refusés.

Confidentialité

CodeSlice AI ne collecte aucune télémétrie et ne transmet aucune donnée à son développeur. Lorsque vous effectuez une requête, les instructions et le contexte sélectionné sont envoyés directement au fournisseur IA choisi. Cela peut inclure le code sélectionné ou joint, un contexte de workspace borné, l’historique récent utile et des captures d’écran.

Deux fonctions optionnelles effectuent des requêtes supplémentaires :

• l’orchestration peut contacter Google Gemini ou OpenAI afin de choisir un profil de tâche et un modèle ;
• l’autocomplétion envoie le code situé avant et après le curseur à l’API FIM Codestral de Mistral.

Les clés API sont stockées dans VS Code SecretStorage. L’export manuel crée un fichier .aikeys chiffré avec AES-256-GCM et protégé par votre phrase secrète.

Le fournisseur actif et l’endpoint du serveur local sont des réglages globaux : un dépôt ne peut pas remplacer leur destination. Les endpoints locaux peuvent utiliser HTTP uniquement sur les adresses loopback ; les serveurs auto-hébergés distants doivent utiliser HTTPS. Une clé de passerelle locale facultative n’est acceptée que pour l’endpoint auquel elle a été associée.

Les réglages, modèles personnalisés et conversations sont stockés localement par VS Code. Les données envoyées à un fournisseur IA sont soumises à ses propres conditions et règles de conservation. Vérifiez-les avant d’utiliser CodeSlice AI avec du code sensible ou confidentiel.

Le harnais conserve au maximum 500 métriques numériques locales, sans prompt, code ni chemin brut. La page de paramètres permet de les exporter ou de les purger. CodeSlice AI : Capturer la dernière fixture du harnais est une action volontaire distincte qui enregistre le dernier échange complet dans un fichier JSON choisi.

Contexte du projet

Le mode smart, activé par défaut, peut inclure :

• la sélection et le symbole englobant ;
• les imports et des fichiers liés probables ;
• les fichiers ouverts et un aperçu borné du projet ;
• les définitions et consommateurs d’identifiants importants.

L’inspecteur de contexte indique les fichiers retenus, le volume estimé, les raisons de sélection, la troncature et les exclusions sensibles avant l’envoi. Le mode selectionOnly limite l’envoi au code explicitement sélectionné.

Commandes du chat

Dans le chat, saisissez / pour afficher les commandes disponibles. Avec /edit, le chat retire le préfixe de la commande avant d’envoyer votre consigne au modèle.

• /new : nouvelle conversation ;
• /model : choisir le modèle de la conversation ;
• /settings : ouvrir la page de paramètres ;
• /selection : joindre la sélection active ;
• /file : joindre le fichier actif ;
• /files : choisir plusieurs fichiers ;
• /edit <instruction> : demander au chat de préparer une modification de code pour ce tour.

Le chat distingue les demandes de réponse, de revue et de modification. Une consigne comme « sans modifier » reste conversationnelle et ne déclenche pas d’édition.

Dans un workspace local approuvé, les réponses et revues peuvent mener une investigation bornée avec des outils en lecture seule, indépendamment du mode agent. Le modèle peut chercher des fichiers, examiner symboles, références et diagnostics, découvrir les dépôts et branches, consulter l’historique, résoudre les références et ancêtres communs, comparer des références explicites ou une branche depuis son ancêtre commun, et lire les fichiers historiques. Les noms de branche comme feature/#150-tracking-temps et les demandes naturelles ne nécessitent aucune syntaxe spéciale de SHA. Une revue doit établir le périmètre demandé et demander une précision si sa base est ambiguë ; les fichiers courants servent de contexte et ne remplacent pas un diff inaccessible. Git reste local, sans fetch, checkout, écriture ni commande shell. Plusieurs racines nécessitent un choix explicite. Les chemins sensibles ou exclus sont omis ; les pages restantes et les lacunes doivent être signalées. L’investigation affiche sa progression puis la réponse finale, conserve le modèle après son premier résultat réussi et partage le budget cumulé du harnais configuré, routage et résumé inclus. Les fournisseurs sans outils natifs utilisent les mêmes outils bornés via un protocole JSON textuel. Sans workspace local approuvé, le chat conserve la réponse en streaming à partir du contexte joint.

Commandes principales

Les raccourcis liés au code s’appliquent lorsque le focus est dans l’éditeur.

Paramètres

CodeSlice AI : Paramètres ouvre une page unique regroupant tous les réglages : modèles, ordre des modèles par tâche, clés API, autocomplétion, tâches complexes et options avancées. L’élément de la barre d’état et Ctrl+Alt+A y mènent tous les deux.

Son objet principal est l’ordre des modèles par type de tâche. Le chat classe chaque demande en réponse, plan d’implémentation, revue, ou modification simple, logique ou large, puis utilise le premier modèle de la liste correspondante disposant d’une clé API, et passe au suivant en cas d’échec. Chaque liste est une carte que vous réordonnez en faisant glisser une ligne ou avec les flèches, une pastille indiquant les modèles réellement utilisables. Personnaliser part de l’ordre intégré, Restaurer l’ordre intégré revient en arrière.

Les tentatives de secours partagent un délai global de deux minutes. Les erreurs propres à la requête, qu’un autre modèle ne pourrait pas corriger, arrêtent immédiatement la chaîne ; une clé refusée ou sans crédit fait ignorer les autres modèles qui utilisent les mêmes identifiants chez ce fournisseur.

Les réglages rapides restent disponibles pour une navigation entièrement au clavier et couvrent les mêmes options.

Pour un serveur auto-hébergé, choisissez Serveur local comme fournisseur par défaut dans les paramètres utilisateur de VS Code. Renseignez l’adresse de base de l’API dans codeslice-ai.localBaseUrl (par exemple http://localhost:11434/v1) et le nom exact du modèle fourni par le serveur dans codeslice-ai.localModel. Ajoutez une clé de passerelle uniquement si le serveur l’exige.

Autocomplétion Codestral

L’autocomplétion utilise codestral-latest via Mistral et reste indépendante du fournisseur de chat actif.

1. Configurez une clé Mistral dans la page de paramètres, section autocomplétion.
2. Lancez CodeSlice AI : Activer/désactiver l’autocomplétion Codestral.
3. Tapez dans un fichier texte et acceptez une suggestion avec Tab.

Évaluation du développement agentique

Le chat préserve la demande et les instructions indispensables : si elles dépassent le contexte disponible, l’envoi est refusé localement et le brouillon reste disponible. Seules les pièces jointes textuelles et l’historique peuvent être réduits, avec une indication visible. Les dossiers homonymes sont identifiés séparément ; un chemin conversationnel ambigu nécessite un choix explicite du dossier.

L’activité de recherche peut être dépliée indépendamment de la réponse : outils, chemins relatifs, durées, résultats indisponibles ou tronqués et pages restantes. Les préambules sont conservés dans cette activité ; les réponses JSON ordinaires restent affichables.

Le mode agent distingue les modifications dans l’éditeur, leur sauvegarde sur disque et leur validation. Une application partielle ou une sauvegarde échouée arrête le cycle sans nouvelle tentative automatique. Les résultats sont liés à la révision testée ; une modification ultérieure ou un rechargement impose une nouvelle vérification et une reprise explicitement autorisée. L’historique des validations reste disponible.

npm run test:agent:host lance les scénarios d’intégration dans VS Code installé, avec un profil et un workspace temporaires isolés. Le rapport JSON distingue ce test d’intégration des simulations hors ligne et des mesures de qualité avec fournisseur réel. Il couvre notamment le refus de contexte trop volumineux, les doubles actions, les échecs d’application/sauvegarde, la reprise et l’arrêt de l’arbre des processus de validation. Les artefacts sont conservés en cas d’échec. Ce profil jetable désactive la demande de confiance pour ses seules fixtures ; les réglages de votre profil habituel ne changent pas. Ce mécanisme n’est pas une sandbox système.

npm run eval:agent:smoke exécute cinq tâches reproductibles dans des copies temporaires : correction d’un bug, modification multi-fichiers, ajout de tests, instructions imbriquées et correction après validation échouée. Les validations et les assertions indépendantes sont réellement exécutées ; les réponses du fournisseur sont simulées. Ce smoke test ne mesure donc pas la qualité d’un modèle.

Pour utiliser un fournisseur réel : npm run eval:agent -- --measured config.json --output rapport.json. La configuration contient provider, model, allowGeneratedCodeExecution: true et adapter: { id, executable, args, cwd?, timeoutMs? }. L’adaptateur reçoit une requête JSON sur stdin et renvoie un EvaluationResponse JSON sur stdout, selon les types de src/harness/evaluation.ts. Conservez les secrets dans son environnement, jamais dans la configuration ou les arguments. Le rapport sépare consommation réelle, estimations et valeurs inconnues.

La comparaison oppose une baseline expérimentale à appel unique (single-shot) à une boucle outillée (role-loop), avec le même fournisseur et le même modèle. Elle ne reproduit pas intégralement les deux parcours du chat VS Code et ne démontre pas une parité avec Claude Code ou Codex. Les copies temporaires protègent le dépôt de travail des écritures du runner ; exécuter du code généré nécessite un environnement de confiance ou une isolation système adaptée.

Paramètres par défaut

• fournisseur : openrouter ;
• modèle OpenRouter : qwen/qwen3-coder:free ;
• température : 0.3 ;
• nombre maximal de jetons de sortie : automatique selon le modèle ;
• contexte workspace : smart ;
• réponses : aperçu Markdown ;
• streaming : activé ;
• orchestration : désactivée ;
• mode agent avec autorisation initiale (expérimental) : activé ;
• autocomplétion Codestral : désactivée, mode balanced.

La page de paramètres permet de changer ces valeurs, gérer les clés et modèles, réordonner les modèles utilisés pour chaque type de tâche et tester l’appel API actif.

Assistance

Utilisez les Issues GitHub pour signaler un bug ou proposer une amélioration. N’y publiez aucune clé API, donnée personnelle, partie de code privé ou autre information sensible.

Si CodeSlice AI vous fait gagner du temps, vous pouvez soutenir son développement sur Ko-fi.

Développement local / Local development

Avec Node.js 20, installez les dépendances avec npm ci. Ouvrez le dépôt dans VS Code et appuyez sur F5 pour compiler et lancer l’extension dans une fenêtre de développement. En terminal, npm run compile compile le projet et npm test compile puis lance les tests Node.js.

With Node.js 20, install dependencies with npm ci. Open the repository in VS Code and press F5 to build and launch the extension in an Extension Development Host. From a terminal, npm run compile builds the project and npm test builds it and runs the Node.js test suite.

License / Licence

Proprietary license — all rights reserved. See the LICENSE file included with the extension.

Licence propriétaire — tous droits réservés. Consultez le fichier LICENSE inclus avec l’extension.