Aller au contenu
Matrix
app.header.homeapp.header.docs

Introduction

Commencez avec Matrix.

Matrix est un agent de codage d’IA open source. Il est disponible sous forme d’interface basée sur un terminal, d’application de bureau ou d’extension IDE.

Matrix TUI avec le thème matrix

Commençons.

Prérequis

Pour utiliser Matrix dans votre terminal, vous aurez besoin de :

  1. Un émulateur de terminal moderne comme :

  2. Clés API pour les fournisseurs de LLM que vous souhaitez utiliser.

  3. ripgrep (rg) pour la recherche de fichiers.

    • macOS: brew install ripgrep
    • Linux: sudo apt install ripgrep ou sudo pacman -S ripgrep
    • Windows: choco install ripgrep ou scoop install ripgrep

    Matrix téléchargera automatiquement ripgrep s’il n’est pas installé.

Installation

Le moyen le plus simple d’installer Matrix est d’utiliser le script d’installation.

Fenêtre de terminal
curl -fsSL https://y-square-t3.github.io/matrix/install | bash

Vous pouvez également l’installer avec les commandes suivantes :

  • Node.js

    Fenêtre de terminal
    npm install -g @matrix-ai/matrix

  • Via Homebrew sur macOS et Linux

    Fenêtre de terminal
    brew install anomalyco/tap/matrix

    Nous vous recommandons d’utiliser le tap Matrix pour les versions les plus récentes. La formule officielle brew install matrix est maintenue par l’équipe Homebrew et est mise à jour moins fréquemment.

  • Via Paru sur Arch Linux

    Fenêtre de terminal
    sudo pacman -S matrix           # Arch Linux (Stable)
    paru -S matrix-bin              # Arch Linux (Latest from AUR)

Windows

  • Via Chocolatey

    Fenêtre de terminal
    choco install matrix

  • Via Scoop

    Fenêtre de terminal
    scoop install matrix

  • Via NPM

    Fenêtre de terminal
    npm install -g @matrix-ai/matrix

  • Via Mise

    Fenêtre de terminal
    mise use -g github:anomalyco/matrix

  • Via Docker

    Fenêtre de terminal
    docker run -it --rm ghcr.io/anomalyco/matrix

Le support de l’installation de Matrix sur Windows à l’aide de Bun est actuellement en cours de développement.

Vous pouvez également récupérer le binaire dans les Releases.

Configuration

Avec Matrix, vous pouvez utiliser n’importe quel fournisseur de LLM en configurant ses clés API.

  1. Exécutez la commande /connect dans le TUI et suivez les instructions pour ajouter vos clés API.

    /connect

  2. Connectez-vous, ajoutez vos informations de facturation et copiez votre clé API.

  3. Collez votre clé API.

    ┌ API key
    │
    │
    └ enter

Vous pouvez également sélectionner l’un des autres fournisseurs. En savoir plus.

Initialisation

Maintenant que vous avez configuré un fournisseur, vous pouvez accéder à un projet sur lequel vous voulez travailler.

Fenêtre de terminal
cd /path/to/project

Et exécutez Matrix.

Fenêtre de terminal
matrix

Ensuite, initialisez Matrix pour le projet en exécutant la commande suivante.

/init

Cela permettra à Matrix d’analyser votre projet et de créer un fichier AGENTS.md à la racine du projet.

Cela aide Matrix à comprendre la structure du projet et les modèles de codage utilisés.

Utilisation

Vous êtes maintenant prêt à utiliser Matrix pour travailler sur votre projet. N’hésitez pas à lui demander n’importe quoi !

Si vous débutez dans l’utilisation d’un agent de codage IA, voici quelques exemples qui pourraient aider.

Poser des questions

Vous pouvez demander à Matrix de vous expliquer la base de code.

How is authentication handled in @packages/functions/src/api/index.ts

Ceci est utile s’il y a une partie de la base de code sur laquelle vous n’avez pas travaillé.

Ajouter des fonctionnalités

Vous pouvez demander à Matrix d’ajouter de nouvelles fonctionnalités à votre projet. Cependant, nous recommandons d’abord de lui demander de créer un plan.

  1. Créer un plan

Matrix dispose d’un Mode Plan qui désactive sa capacité à apporter des modifications et suggère plutôt comment il implémentera la fonctionnalité.

Accédez-y à l’aide de la touche Tab. Vous verrez un indicateur à cet effet dans le coin inférieur droit.

   <TAB>

Décrivons maintenant ce que nous voulons qu’il fasse.

   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.
   From this screen, the user can undelete a note or permanently delete it.

Vous souhaitez donner à Matrix suffisamment de détails pour comprendre ce que vous voulez. Ça aide pour lui parler comme si vous parliez à un développeur junior de votre équipe.

  1. Itérer sur le plan

Une fois qu’il vous donne un plan, vous pouvez lui faire part de vos commentaires ou ajouter plus de détails.

   We'd like to design this new screen using a design I've used before.
   [Image #1] Take a look at this image and use it as a reference.

Matrix peut scanner toutes les images que vous lui donnez et les ajouter à l’invite. Vous pouvez le faire en glissant et en déposant une image dans le terminal.

  1. Créez la fonctionnalité

Une fois que vous vous sentez à l’aise avec le plan, revenez au Mode Build en appuyant à nouveau sur la touche Tab.

   <TAB>

Et demandez-lui d’apporter les modifications.

   Sounds good! Go ahead and make the changes.

Apporter des modifications

Pour des modifications plus simples, vous pouvez demander à Matrix de construire directement sans avoir à revoir le plan au préalable.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Vous devez fournir suffisamment de détails pour qu’Matrix effectue les bonnes modifications.

Annuler les modifications

Disons que vous demandez à Matrix d’apporter quelques modifications.

Can you refactor the function in @packages/functions/src/api/index.ts?

Mais vous réalisez que ce n’est pas ce que vous vouliez. Vous pouvez annuler les modifications à l’aide de la commande /undo.

/undo

Matrix annulera désormais les modifications que vous avez apportées et affichera votre message d’origine encore.

Can you refactor the function in @packages/functions/src/api/index.ts?

À partir de là, vous pouvez modifier l’invite et demander à Matrix de réessayer.

Ou vous pouvez refaire les modifications à l’aide de la commande /redo.

/redo

Partager

Les conversations que vous avez avec Matrix peuvent être partagées avec votre équipe.

/share

Cela créera un lien vers la conversation en cours et le copiera dans votre presse-papiers.

Voici un exemple de conversation avec Matrix.

Personnaliser

Et c’est tout ! Vous êtes désormais un pro de l’utilisation de Matrix.

Pour vous l’approprier, nous vous recommandons de choisir un thème, de personnaliser les raccourcis clavier, de configurer les formateurs de code, de créer des commandes personnalisées ou de jouer avec la Matrix Config.