Mastra Code

Mastra Code: Интеллектуальный терминальный агент для современной разработки

Mastra Code представляет собой передовой терминальный AI-агент для написания кода, созданный на базе примитивов Harness, Agent и Memory платформы Mastra. Это мощное решение работает непосредственно в вашем терминале, обеспечивая бесшовное соединение с более чем 70 моделями искусственного интеллекта.

Mastra Code предоставляет разработчикам комплексный набор инструментов для чтения, поиска, редактирования и исполнения программного кода, превращая обычную консоль в полноценную среду для совместной работы с ИИ.

Что такое Mastra Code

Mastra Code — это не просто чат-бот, а автономный агент, глубоко интегрированный в вашу файловую систему и рабочий процесс. Продукт построен на четырех технологических уровнях:

• TUI (Terminal User Interface): Пользовательский интерфейс на базе компонентов pi-tui.
• Harness: Слой управления режимами, сохранения тредов, обработки событий и управления состоянием.
• Mastra Agent: Ядро, отвечающее за динамический выбор моделей, выполнение инструментов, интеграцию памяти и работу с субагентами.
• LibSQL Storage: Система хранения для персистентности тредов, истории сообщений, отслеживания токенов и обсервационной памяти.

Основные возможности Mastra Code

Возможности Mastra Code структурированы по нескольким ключевым направлениям, обеспечивающим максимальную гибкость:

Специализированные режимы (Modes)

Вы можете переключаться между режимами Build, Plan и Fast в зависимости от текущей задачи, оптимизируя потребление ресурсов и точность ответов.

Встроенный инструментарий (Tools)

Mastra Code оснащен инструментами для:

• Просмотра и редактирования файлов.
• Полнотекстового поиска по проекту.
• Выполнения shell-команд.
• Поиска информации в веб-сети.

Конфигурация и расширяемость

• Настройка: Поддержка MCP-серверов, хуков, кастомных навыков (skills) и настроек базы данных.
• Кастомизация: Возможность программного расширения через собственные режимы, инструменты, субагентов и системы хранения.
• Многомодельность: Смена AI-провайдеров прямо в процессе диалога для сравнения результатов.

Инструкция по использованию (How to Use)

Предварительные требования

Для работы Mastra Code требуется установленная среда Node.js версии 22.13.0 или новее.

Установка и запуск

Установить Mastra Code можно глобально с помощью любого популярного пакетного менеджера:

• npm install -g mastracode
• pnpm install -g mastracode
• yarn global add mastracode
• bun add -g mastracode

Также доступен запуск без установки через npx: npx mastracode

Начало работы

1. Перейдите в директорию вашего проекта: cd your-project.
2. Запустите агент командой: mastracode.
3. Настройте API-ключ (например, export ANTHROPIC_API_KEY=sk-ant-...) или выполните команду /login для аутентификации через Anthropic или OpenAI.
4. Начните вводить сообщения. Агент будет отвечать потоковым текстом и сможет выполнять операции с кодом в вашем проекте.

Управление через Slash-команды

• /new — начать новый тред.
• /models — выбрать другую модель ИИ.
• /mode — переключить режим работы.
• /diff — показать измененные файлы за сессию.
• /exit — выход из интерфейса.

Горячие клавиши

• Ctrl+C: Прервать текущую операцию.
• Ctrl+T: Переключить видимость блоков размышлений (thinking blocks).
• Ctrl+E: Развернуть или свернуть выводы инструментов.

Сценарии использования (Use Case)

Mastra Code адаптируется под разные стили работы, обеспечивая эффективность как в малых, так и в масштабных проектах.

1. Ежедневное написание кода: Задавайте вопросы по кодовой базе, вносите правки, запускайте тесты и управляйте Git-репозиторием.
2. Исследование кода (Exploration): Используйте режим Plan для глубокого анализа архитектуры и создания детальных планов реализации перед написанием кода.
3. Быстрые правки: Режим Fast идеально подходит для коротких ответов и мелких исправлений с минимальной задержкой.
4. Тестирование моделей: Сравнивайте ответы от разных провайдеров (OpenAI, Anthropic и др.) в рамках одной беседы.

FAQ (Часто задаваемые вопросы)

Какие модели поддерживает Mastra Code?

Инструмент поддерживает подключение к более чем 70 моделям ИИ через различных провайдеров.

Можно ли использовать Mastra Code вне директории проекта?

Да, с помощью команды /sandbox вы можете добавить внешние директории в список разрешенных путей для агента.

Как отслеживать расходы на API?

Используйте команду /cost, чтобы увидеть использование токенов для текущей беседы.

Можно ли менять визуальное оформление?

Да, команда /theme позволяет переключаться между автоматической, темной и светлой цветовыми схемами интерфейса.