Mastra Code

Qu'est-ce que Mastra Code ?

Mastra Code est un agent IA de codage en terminal construit avec les primitives Harness, Agent et Memory de Mastra. Il s'exécute dans votre terminal, se connecte à 70+ modèles IA et prend en charge des flux de travail interactifs comme la lecture, la recherche, la modification et l'exécution de code dans votre projet.

L'objectif principal de l'agent est de vous aider à réaliser des tâches de codage via une interface utilisateur en terminal (TUI), des modes structurés et une gestion de sessions limitées au projet. Il est conçu pour organiser la façon dont l'agent pense et agit — que vous souhaitiez une recherche rapide, une implémentation planifiée ou une boucle complète de construction et de test.

Fonctionnalités principales

• Interface terminal (TUI) : Fournit une TUI soignée dans votre terminal (composants pi-tui) pour une utilisation interactive de l'agent, au lieu d'une application web séparée.
• Support multi-modèles (70+ modèles) : Se connecte à 70+ modèles IA et permet de changer de modèle en cours de conversation pour des flux multi-modèles.
• Contrôle de flux par modes : Passez entre les modes Build, Plan et Fast pour adapter les réponses de l'agent (ex. : implémentation vs. réponses rapides).
• Sessions limitées au projet et contexte persistant : Utilise la persistance des threads et l'historique des messages pour organiser les conversations par projet.
• Outils de codage dans l'agent : Inclut des outils intégrés pour la visualisation de fichiers, la modification, la recherche, les commandes shell et la recherche web afin de supporter des tâches de codage de bout en bout.
• Comportement de l'agent configurable : Prend en charge la configuration limitée au projet, incluant les serveurs MCP, les hooks, les commandes personnalisées, les compétences et les paramètres de base de données.
• Personnalisation programmatique : Étendez Mastra Code avec des modes, outils, sous-agents et stockages personnalisés.

Comment utiliser Mastra Code

1. Installez globalement avec l'une des commandes fournies (npm, pnpm ou yarn), par ex. npm install -g mastracode.
2. Accédez au répertoire de votre projet : cd your-project et lancez Mastra Code avec mastracode.
3. Définissez une clé API pour votre fournisseur préféré (exemple pour Anthropic via export ANTHROPIC_API_KEY=...) ou authentifiez-vous avec /login (abonnement Anthropic ou OpenAI mentionné).
4. Envoyez un message dans le terminal ; l'agent répond avec du texte en streaming et peut lire, modifier et exécuter du code dans votre projet.
5. Utilisez les commandes slash et raccourcis clavier pour gérer les sessions, changer de modèles et modes, et contrôler la TUI (ex. : /threads, /models, /mode, /cost, /login, /exit).

Cas d'usage

• Assistant de codage quotidien : Posez des questions sur votre codebase, demandez des modifications, exécutez des tests et gérez des tâches Git tout en restant dans le même flux terminal.
• Exploration de code et planification d'architecture : Utilisez le mode Plan pour analyser l'architecture et générer un plan d'implémentation avant d'écrire du code.
• Recherches rapides et petits changements : Passez en mode Fast pour des réponses brèves et des modifications mineures avec une latence minimale.
• Comparaison multi-fournisseurs : Comparez les réponses de différents modèles IA à la même question de codage en changeant de modèle en cours de conversation.
• Gestion de sessions et paramètres pendant le développement : Utilisez les commandes slash pour démarrer de nouveaux threads de conversation, lister les threads par projet, cloner des threads, voir l'usage des tokens et ajuster les paramètres/thème.

FAQ

Quelles sont les exigences système de Mastra Code ?
Mastra Code nécessite Node.js 22.13.0 ou ultérieur.

Comment m'authentifier auprès d'un fournisseur IA ?
Vous pouvez définir une clé API en variable d'environnement pour votre fournisseur (exemple Anthropic montré) ou exécuter /login pour vous authentifier avec un abonnement Anthropic ou OpenAI.

Puis-je changer de modèles IA et de modes pendant l'utilisation de l'agent ?
Oui. L'agent fournit des commandes slash pour sélectionner un autre modèle IA et passer entre les modes Build, Plan et Fast.

Comment Mastra Code organise-t-il les conversations ?
Il utilise des threads limités au projet avec un historique de conversation persistant, vous permettant de lister, cloner et gérer les threads dans un projet.

Mastra Code prend-il en charge la personnalisation des outils ou du comportement de l'agent ?
Oui. Vous pouvez configurer des fonctionnalités comme les serveurs MCP, les hooks, les commandes personnalisées, les compétences et les paramètres de base de données, et étendre l'agent avec des modes, outils, sous-agents et stockages personnalisés.

Alternatives

• Outils IA de codage intégrés à un IDE local : Les alternatives qui s'exécutent dans les éditeurs/IDEs offrent une assistance contextuelle au code, mais se concentrent généralement sur des suggestions en ligne plutôt que sur un flux de travail d'agent priorisant le terminal avec des modes explicites.
• Chat LLM en terminal polyvalent avec outils personnalisés : Un agent de chat en terminal peut être étendu avec des scripts pour modifier des fichiers et exécuter des commandes, mais vous devrez peut-être faire plus de configuration pour reproduire les outils intégrés de Mastra Code, la gestion des modes et la structure des sessions/fils de discussion.
• Assistants de codage basés sur des workflows (style plan/build) : Les outils qui mettent l'accent sur la planification avant l'implémentation peuvent correspondre à l'idée du « Plan mode » ; les différences proviennent généralement de la gestion de l'exécution des outils (édition/recherche/shell) et des fils de discussion persistants par projet.
• Frameworks d'agents pour tâches de codage : Les frameworks d'agents généraux peuvent servir à construire un agent de codage avec mémoire et outils, mais Mastra Code regroupe ces primitives dans une TUI terminal prête à l'emploi.