Mastra Code

Что такое Mastra Code?

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

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

Ключевые возможности

• Интерфейс терминала (TUI): Обеспечивает отполированный TUI в терминале (компоненты pi-tui) для интерактивного использования агента вместо отдельного веб-приложения.
• Поддержка множества моделей (70+ моделей): Подключается к 70+ моделям ИИ и позволяет переключаться между моделями во время разговора для много-модельных рабочих процессов.
• Управление рабочими процессами по режимам: Переключайтесь между режимами Build, Plan и Fast, чтобы агент отвечал так, как вам нужно (например, реализация vs. быстрые ответы).
• Сессии в рамках проекта и постоянный контекст: Использует постоянство потоков и историю сообщений, чтобы разговоры организовывались по проектам.
• Инструменты кодирования в агенте: Включает встроенные инструменты для просмотра файлов, редактирования, поиска, команд shell и веб-поиска для поддержки задач кодирования от начала до конца.
• Настраиваемое поведение агента: Поддерживает конфигурацию в рамках проекта, включая серверы MCP, хуки, пользовательские команды, навыки и настройки базы данных.
• Программная кастомизация: Расширяйте Mastra Code пользовательскими режимами, инструментами, субагентами и хранилищами.

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

1. Установите глобально с помощью одной из предоставленных команд (npm, pnpm или yarn), например npm install -g mastracode.
2. Перейдите в директорию проекта: cd your-project и запустите Mastra Code командой mastracode.
3. Установите API-ключ для предпочитаемого провайдера (пример для Anthropic: export ANTHROPIC_API_KEY=...) или аутентифицируйтесь с помощью /login (упоминаются подписки Anthropic или OpenAI).
4. Отправьте сообщение в терминале; агент отвечает потоковым текстом и может читать, редактировать и выполнять код в вашем проекте.
5. Используйте слеш-команды и сочетания клавиш для управления сессиями, переключения моделей и режимов, управления TUI (например, /threads, /models, /mode, /cost, /login, /exit).

Примеры использования

• Ежедневный ассистент по кодированию: Задавайте вопросы о кодовой базе, запрашивайте правки, запускайте тесты и управляйте задачами Git, оставаясь в одном терминальном рабочем процессе.
• Изучение кода и планирование архитектуры: Используйте режим Plan, чтобы анализировать архитектуру и генерировать план реализации перед написанием кода.
• Быстрые поиски и мелкие изменения: Переключайтесь в режим Fast для кратких ответов и мелких правок с минимальной задержкой.
• Сравнение провайдеров: Сравнивайте ответы разных моделей ИИ на один и тот же вопрос по кодированию, переключая модели во время разговора.
• Управление сессиями и настройками в разработке: Используйте слеш-команды для запуска новых потоков разговоров, просмотра потоков по проекту, клонирования потоков, просмотра использования токенов и настройки темы.

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

Какие системные требования у Mastra Code?
Mastra Code требует Node.js 22.13.0 или новее.

Как аутентифицироваться у провайдера ИИ?
Вы можете установить переменную окружения с API-ключом для провайдера (приведён пример для Anthropic) или выполнить /login для аутентификации по подписке Anthropic или OpenAI.

Можно ли переключать модели ИИ и режимы во время работы агента?
Да. Агент предоставляет слеш-команды для выбора другой модели ИИ и переключения между режимами Build, Plan и Fast.

Как Mastra Code организует разговоры?
Он использует потоки в рамках проекта с постоянной историей разговоров, что позволяет перечислять, клонировать и управлять потоками в проекте.

Поддерживает ли Mastra Code настройку инструментов или поведения агента?
Да. Вы можете настроить функции вроде серверов MCP, хуков, пользовательских команд, навыков и настроек базы данных, а также расширить агент пользовательскими режимами, инструментами, субагентами и хранилищами.

Альтернативы

• Локальные AI-инструменты для кода, интегрированные в IDE: Альтернативы, работающие внутри редакторов/IDE, обеспечивают контекстную помощь по коду, но обычно фокусируются на встроенных подсказках, а не на терминальной агентной рабочей среде с явными режимами.
• Универсальные терминальные LLM-чаты с кастомными инструментами: Терминальный чат-агент можно расширить скриптами для редактирования файлов и выполнения команд, но потребуется больше настройки, чтобы воспроизвести встроенные инструменты Mastra Code, обработку режимов и структуру сессий/веток.
• Ассистенты для кода на основе workflow (стиль plan/build): Инструменты, акцентирующие планирование перед реализацией, могут соответствовать идее «Plan mode»; различия обычно в обработке выполнения инструментов (редактирование/поиск/shell) и постоянных веток проекта.
• Фреймворки агентов для задач кодирования: Общие фреймворки агентов можно использовать для создания кодового агента с памятью и инструментами, но Mastra Code упаковывает эти примитивы в готовый терминальный TUI.