zemit/README.md

# Zemit

Génère des messages de commit, via un modèle d'IA, directement dans VSCode.

![preview](/assets/preview.jpg)

## Ce que ça fait

Zemit lit le diff stagé et le résumé des fichiers modifiés dans ton dépôt Git, puis envoie ce contexte à un modèle d'IA pour produire un message de commit. Le message apparaît directement dans le champ de saisie du panneau Source Control.

Tu peux interrompre la génération à tout moment depuis le même panneau.

## Prérequis

- VS Code 1.85 ou plus récent
- Un dépôt Git avec des changements stagés
- Une clé API pour le fournisseur choisi (non requise pour Ollama et Claude Code)

## Installation

### Via le marketplace (recommandé)

Recherche **Zemit** dans l'onglet Extensions de ton éditeur, ou installe directement depuis :

- **VS Code** : [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=hykocx.zemit)
- **VSCodium / Open VSX** : [open-vsx.org](https://open-vsx.org/extension/hykocx/zemit)

### Via un fichier VSIX

1. Télécharge le fichier `.vsix` depuis les [releases](https://git.hyko.cx/hykocx/zemit/releases).
2. Ouvre la palette de commandes (`Ctrl+Shift+P` / `Cmd+Shift+P`).
3. Cherche **Extensions: Installer depuis un fichier VSIX...** et sélectionne le fichier téléchargé.

Ou via le menu **Extensions** (icône en barre latérale) → `...` → **Installer depuis un fichier VSIX...**

## Configuration

Les paramètres se trouvent dans les préférences VS Code sous **Zemit**.

| Paramètre | Description | Défaut |
|---|---|---|
| `zemit.provider` | Fournisseur d'IA : `anthropic`, `openai`, `ollama` ou `claudecode` | `anthropic` |
| `zemit.apiKey` | Clé API du fournisseur (inutile pour Ollama et Claude Code) | _(vide)_ |
| `zemit.model` | Modèle à utiliser | `claude-sonnet-4-6` |
| `zemit.baseUrl` | URL de base personnalisée (ex. Ollama local) | _(vide)_ |
| `zemit.promptVersion` | Version du prompt | `zemit-v2` |
| `zemit.maxDiffSize` | Taille maximale du diff envoyé à l'IA (en caractères) | `5000` |

Pour choisir un modèle parmi ceux disponibles chez ton fournisseur, lance la commande **Zemit: Select Model** depuis la palette de commandes.

## Utilisation

1. Stage tes fichiers dans le panneau Source Control.
2. Clique sur l'icône ✦ dans la barre du panneau.
3. Le message de commit se remplit automatiquement.

Pour arrêter une génération en cours, clique sur l'icône d'arrêt au même endroit.

## Fournisseurs supportés

- **Anthropic** : modèles Claude (Haiku, Sonnet, Opus)
- **OpenAI** : modèles GPT
- **Ollama** : modèles locaux, aucune clé requise
- **Claude Code** : utilise le CLI `claude` installé localement, aucune clé API requise — l'authentification est gérée par Claude Code lui-même

### Utiliser Claude Code

Assure-toi que le CLI `claude` est installé et accessible (`~/.local/bin/claude` ou dans ton `PATH`), puis configure :

```json
"zemit.provider": "claudecode",
"zemit.model": "claude-sonnet-4-6"
```

> Note : le provider Claude Code ne supporte pas le streaming — le message apparaît d'un coup à la fin de la génération, contrairement aux providers API.

## Développement

```bash
npm install
npm run build   # build unique
npm run watch   # recompile à chaque changement
npm run package # génère le .vsix
```