Votre première session dans VS Code

À la fin de ce tutoriel, Lemniscate sera installé dans votre VS Code, branché sur un modèle qui tourne sur votre machine, et vous aurez obtenu une réponse portant sur du code à vous. Comptez une vingtaine de minutes, dont l’essentiel en téléchargement du modèle.

Lemniscate n’est publié sur aucune place de marché et sur aucun registre de paquets. Vous l’installez depuis l’archive signée que vous a remise l’éditeur.

1. Vérifier l’archive reçue

Vous avez reçu de votre interlocuteur une archive et le fichier d’empreintes qui l’accompagne. Le nom exact de ces deux fichiers vous est indiqué à la livraison ; les commandes ci-dessous les désignent par ARCHIVE et EMPREINTES, à remplacer par ce que vous avez reçu.

Placez-vous dans le répertoire où vous les avez déposés, puis :

sha256sum -c EMPREINTES

Résultat attendu : une ligne par fichier vérifié, chacune terminée par Réussi (OK en anglais). Si une ligne indique ÉCHEC, arrêtez-vous ici : l’archive est incomplète ou altérée, et demandez-en une autre à votre interlocuteur avant d’aller plus loin.

2. Extraire l’archive et localiser l’extension

mkdir -p ~/lemniscate
tar -xzf ARCHIVE -C ~/lemniscate
find ~/lemniscate -name 'lemniscate-*.vsix'

Résultat attendu : la dernière commande affiche un chemin, celui du paquet de l’extension VS Code. L’archive contient aussi le plugin JetBrains et le CLI ; ce tutoriel ne s’en sert pas.

3. Installer l’extension dans VS Code

VSIX=$(find ~/lemniscate -name 'lemniscate-*.vsix' | head -n 1)
code --install-extension "$VSIX"

Résultat attendu : le terminal affiche Extension 'lemniscate-<version>.vsix' was successfully installed. Rouvrez VS Code : une icône Lemniscate est apparue dans la barre d’activité, sur le côté.

4. Figer la version que vous venez d’installer

VS Code met à jour les extensions tout seul. Puisque celle-ci vient d’un fichier et non d’une place de marché, laisser ce mécanisme actif expose la version posée à être remplacée. Coupez-le.

Ouvrez la palette de commandes, lancez Preferences: Open User Settings (JSON), et ajoutez cette entrée :

{
  "extensions.autoUpdate": false
}

Résultat attendu : l’entrée figure dans votre settings.json et VS Code l’accepte sans la souligner. La version que vous avez installée reste en place jusqu’à ce que vous installiez vous-même l’archive suivante.

5. Télécharger le modèle qui répondra

ollama pull llama3.1:8b

Résultat attendu : la barre de progression atteint 100 %, puis success. Le modèle pèse environ 5 Go et s’exécute désormais sur votre machine : vos questions et le code que vous lui montrez ne quittent pas votre poste.

6. Déclarer ce modèle dans votre configuration

Au premier démarrage, Lemniscate a créé ~/.lemniscate/config.yaml avec une liste de modèles vide. Ouvrez ce fichier et remplacez son contenu par :

name: Local Config
version: 1.0.0
schema: v1

models:
  - name: Llama 3.1 8B
    provider: ollama
    model: llama3.1:8b
    roles:
      - chat
      - edit
      - apply

Enregistrez. Lemniscate relit sa configuration au moment de l’enregistrement.

Résultat attendu : dans le panneau Lemniscate, le sélecteur de modèle situé sous la zone de saisie affiche Llama 3.1 8B. S’il affiche encore une liste vide, la configuration comporte une erreur de syntaxe : le panneau l’indique en haut, avec la ligne fautive.

7. Poser votre première question sur votre code

Ouvrez un de vos projets dans VS Code, puis un fichier que vous connaissez bien. Sélectionnez-y une trentaine de lignes — une fonction entière plutôt qu’un fragment. Appuyez sur Ctrl+L (Cmd+L sur macOS), écrivez votre question dans la zone de saisie, et validez :

Que fait ce code, et quels cas d'entrée ne sont pas traités ?

Résultat attendu : le code sélectionné apparaît en bloc de contexte au-dessus de votre question, et la réponse nomme vos propres fonctions, variables et fichiers. C’est le signe que le modèle a lu votre code, et non produit une généralité.

Ce que vous avez obtenu

Un agent de code installé depuis un fichier que vous avez vérifié vous-même, un modèle qui s’exécute sur votre poste, et une conversation où le contexte est exactement ce que vous avez sélectionné.

Ce dernier point est une propriété du produit, pas une limite de ce tutoriel : rien n’est indexé tant que vous ne l’avez pas demandé. Lemniscate ne parcourt pas votre dépôt en arrière-plan, et il ne voit d’autre code que celui que vous lui montrez.

Pour continuer

• Fournisseurs de modèles — les autres fournisseurs acceptés par le champ provider, si Ollama n’est pas celui que vous garderez.
• Extension VS Code — les réglages et les commandes exposés par l’extension.
• Où passent les données — ce qui sort de votre poste, et ce qui n’en sort pas.