Mastra Code

Mastra Code : L'Agent de Codage IA Révolutionnaire pour votre Terminal

Mastra Code est un agent de codage IA basé sur le terminal (TUI), conçu pour transformer la manière dont les développeurs interagissent avec leur base de code. Construit sur les primitives puissantes de Mastra, à savoir le Harness, l'Agent et la Memory, Mastra Code s'intègre directement dans votre flux de travail pour offrir une assistance intelligente, rapide et précise.

Qu'est-ce que Mastra Code ?

Mastra Code est un outil en ligne de commande qui agit comme un partenaire de programmation. Contrairement aux interfaces de chat classiques, Mastra Code s'exécute localement dans votre terminal et dispose d'un accès direct à vos fichiers. Il se connecte à plus de 70 modèles d'IA différents, vous permettant de choisir le cerveau le plus adapté à vos besoins.

L'outil utilise une architecture robuste à quatre couches :

• L'interface utilisateur terminal (TUI) : Basée sur les composants pi-tui.
• Harness : Gère les modes, la persistance des discussions et le système d'événements.
• Mastra Agent : Orchestre la sélection dynamique du modèle, l'exécution des outils et la gestion des sous-agents.
• Stockage LibSQL : Assure la persistance des fils de discussion et l'historique des messages.

Caractéristiques principales de Mastra Code

Modes de fonctionnement polyvalents

Mastra Code propose trois modes distincts pour s'adapter à chaque situation :

• Mode Build : Pour la création active de code et les modifications substantielles.
• Mode Plan : Idéal pour analyser l'architecture et concevoir des plans d'implémentation avant d'écrire la moindre ligne.
• Mode Fast : Optimisé pour des réponses rapides et des micro-éditions avec une latence minimale.

Outils intégrés puissants

L'agent Mastra Code dispose d'une suite d'outils natifs pour manipuler votre environnement :

• Lecture, recherche et édition de fichiers.
• Exécution de commandes shell et tests unitaires.
• Recherche web intégrée pour les documentations récentes.
• Gestion des serveurs MCP (Model Context Protocol).

Personnalisation et Extension

Vous pouvez étendre les capacités de Mastra Code de manière programmatique en ajoutant :

• Des outils personnalisés et des sous-agents.
• Des commandes slash spécifiques définies en Markdown.
• Des configurations de base de données et des hooks de projet.

Cas d'utilisation (Use Case)

L'utilisation de Mastra Code est particulièrement pertinente dans les scénarios suivants :

1. Codage quotidien : Posez des questions sur votre propre base de code, effectuez des modifications complexes et gérez vos commits Git sans quitter le terminal.
2. Exploration de code : Utilisez le Plan mode pour comprendre une architecture héritée ou planifier une refactorisation majeure.
3. Workflows Multi-modèles : Comparez instantanément les réponses de différents fournisseurs d'IA (Anthropic, OpenAI, etc.) au milieu d'une conversation pour obtenir le meilleur résultat possible.
4. Débogage rapide : Identifiez des erreurs et lancez des scripts de test via les commandes shell intégrées.

Comment utiliser Mastra Code

Prérequis

Pour faire fonctionner Mastra Code, vous devez disposer de Node.js version 22.13.0 ou une version ultérieure.

Installation et démarrage

Vous pouvez installer Mastra Code globalement via votre gestionnaire de paquets préféré :

npm install -g mastracode
# ou via npx
npx mastracode

Ensuite, accédez à votre projet et lancez l'agent :

cd votre-projet
mastracode

Configuration de l'authentification

Configurez votre clé API (par exemple : export ANTHROPIC_API_KEY=sk-ant-...) ou utilisez la commande de connexion intégrée :

/login pour vous authentifier avec un abonnement Anthropic ou OpenAI.

Commandes Slash essentielles

| Commande | Description | | :--- | :--- | | /new | Démarrer une nouvelle conversation | | /models | Changer le modèle d'IA utilisé | | /mode | Basculer entre Build, Plan et Fast | | /diff | Afficher les fichiers modifiés dans la session | | /cost | Voir l'utilisation des jetons (tokens) |

Raccourcis clavier utiles

• Ctrl+C : Interrompre l'opération en cours.
• Ctrl+T : Basculer la visibilité des blocs de réflexion (thinking blocks).
• Ctrl+F : Envoyer un message de suivi pendant que l'agent génère une réponse.

FAQ (Foire aux questions)

Q : Quels modèles d'IA Mastra Code supporte-t-il ? A : Mastra Code se connecte à plus de 70 modèles d'IA via différents fournisseurs comme Anthropic et OpenAI. Vous pouvez changer de modèle à tout moment avec la commande /models.

Q : Où sont stockées les données de mes conversations ? A : Mastra Code utilise LibSQL Storage pour la persistance des fils de discussion (threads) et de l'historique des messages, permettant une continuité parfaite entre vos sessions.

Q : Puis-je limiter les répertoires auxquels l'IA a accès ? A : Oui, vous pouvez utiliser la commande /sandbox pour ajouter des répertoires externes à la liste des chemins autorisés.

Q : Est-il possible de voir les modifications avant qu'elles ne soient appliquées ? A : Oui, la commande /diff permet de visualiser précisément tous les fichiers modifiés durant la session actuelle.