Что такое Mastra Code?

Mastra Code — это передовой AI-агент для кодирования, работающий в терминале и предназначенный для бесшовной интеграции в рабочие процессы разработчиков. Созданный на основе надежных примитивов Harness, Agent и Memory от Mastra, он переносит мощь больших языковых моделей непосредственно в ваш интерфейс командной строки. Он действует как интеллектуальный парный программист, способный понимать контекст, выполнять команды и управлять сложными задачами кодирования, никогда не покидая среду терминала.

Этот мощный агент подключается к более чем 70 различным AI-моделям, позволяя разработчикам использовать лучшую модель для конкретных задач или сравнивать результаты работы разных провайдеров в середине диалога. Его основная цель — повышение производительности за счет предоставления немедленного доступа к возможностям чтения, поиска, редактирования и выполнения кода, управляемым через интуитивно понятный текстовый пользовательский интерфейс (TUI).

Ключевые особенности

• Поддержка нескольких моделей: Подключается и поддерживает более 70 AI-моделей, обеспечивая динамическое переключение между провайдерами (например, Anthropic или OpenAI) в рамках одной сессии для оптимальной производительности или управления затратами.
• Режимы рабочего процесса: Предлагает различные режимы работы — Build (общее развитие), Plan (архитектурный анализ и планирование) и Fast (быстрый поиск/редактирование с низкой задержкой) — в соответствии с текущим фокусом разработчика.
• Интегрированные инструменты: Предоставляет встроенные инструменты для основных задач разработки, включая просмотр и редактирование файлов, поиск кода, выполнение команд оболочки и веб-поиск.
• Постоянный контекст и конфигурация: Поддерживает потоки диалогов, привязанные к проекту, серверы MCP, пользовательские хуки и навыки. Постоянство потоков обеспечивает непрерывность между сессиями.
• Расширяемость: Высокая степень настраиваемости, позволяющая разработчикам программно расширять функциональность путем добавления пользовательских режимов, новых инструментов, субагентов и альтернативных решений для хранения данных.
• Отточенный TUI: Имеет современный, отзывчивый терминальный интерфейс, построенный с использованием компонентов pi-tui, обеспечивающий четкую видимость операций, результатов работы инструментов и использования токенов.

Как использовать Mastra Code

Начать работу с Mastra Code просто, но для этого требуется Node.js (версии 22.13.0 или новее) в качестве предварительного условия.

1. Установка: Установите Mastra Code глобально с помощью npm, yarn, bun или запустите его напрямую через npx или bun x:

npm install -g mastracode
# ИЛИ
bun x mastracode

2. Инициализация: Перейдите в каталог вашего проекта и запустите агент:

cd your-project
mastracode

3. Аутентификация: Установите ваш API-ключ как переменную среды (например, export ANTHROPIC_API_KEY=...) или используйте слэш-команду /login для аутентификации через провайдеров OAuth.

4. Взаимодействие: После аутентификации просто введите ваш запрос или команду в TUI. Агент будет потоково передавать ответы и сможет активно читать, редактировать и выполнять код в контексте вашего проекта. Используйте слэш-команды, такие как /mode, для смены рабочих процессов или /threads для управления диалогами.

Сценарии использования

1. Ежедневная рефакторинг и отладка: Быстро попросите агента объяснить сложные функции, предложить улучшения рефакторинга, сгенерировать модульные тесты для конкретных модулей или управлять простыми операциями Git непосредственно из терминала.
2. Архитектурное планирование: Используйте Plan Mode для передачи агенту требований высокого уровня. Он может анализировать существующую структуру кода, предлагать подробные планы реализации и намечать необходимые изменения в файлах до написания какого-либо кода.
3. Быстрое переключение контекста: При работе с устаревшей системой или незнакомой кодовой базой используйте Mastra Code для быстрого поиска (/mode Fast), чтобы мгновенно найти документацию или определить, где инициализируется определенная переменная, не открывая несколько файлов.
4. Тестирование сравнения моделей: Разработчики, работающие над задачами, критичными к производительности, могут переключаться между моделями в середине разговора (например, сравнивая задержку GPT-4o с рассуждениями Claude 3 Opus), чтобы выбрать наиболее подходящий и экономически эффективный ИИ для текущей задачи.
5. Интеграция пользовательских инструментов: Команды могут определять пользовательские слэш-команды или субагенты, адаптированные для внутренних скриптов развертывания или проприетарных взаимодействий с базами данных, встраивая специализированные рабочие процессы непосредственно в возможности агента.

FAQ

В: Каковы минимальные системные требования для запуска Mastra Code? О: Для эффективной работы Mastra Code требуется Node.js версии 22.13.0 или новее. Убедитесь, что ваша среда соответствует этому требованию перед установкой.

В: Как Mastra Code обрабатывает историю диалогов и контекст? О: Он использует LibSQL Storage для сохранения потоков, истории сообщений и отслеживания использования токенов. Диалоги часто привязаны к каталогу проекта, гарантируя, что агент помнит соответствующий контекст между сессиями.

В: Могу ли я определить свои собственные команды для агента? О: Да, Mastra Code обладает высокой расширяемостью. Вы можете определять пользовательские слэш-команды, создавая файлы Markdown, что позволяет настраивать функциональность агента в соответствии с конкретными потребностями вашей организации или внутренними инструментами.

В: Что произойдет, если агент выполняет длительную операцию? О: Вы можете прервать текущую операцию с помощью стандартного сочетания клавиш Ctrl+C. Это позволяет немедленно остановить выполняемую команду оболочки или процесс генерации.

В: Как управлять тем, какого AI-провайдера я использую? О: Вы можете переключать модели в середине разговора с помощью слэш-команды /models или путем установки соответствующих переменных среды API-ключа. Агент поддерживает аутентификацию с основными провайдерами, такими как Anthropic и OpenAI.