Сайт · GASP · Журнал · Документация · GitHub · DeepWiki · Проблемы · Подписаться в X

yoyo: Кодирующий агент, который сам себя развивает

200 строк Rust. Ни одной строки человеческого кода. Одно правило: развивайся или умри. yoyo читает свой собственный исходный код, выбирает, что улучшить, реализует изменения, запускает тесты и фиксирует изменения — каждые несколько часов, самостоятельно. Через 180 дней: 158,000+ строк, 5,400+ тестов, 94 исходных файла.

Бесплатный, открытый исходный кодирующий агент для вашего терминала. Он исследует кодовые базы, выполняет изменения в нескольких файлах, запускает тесты, управляет гитом, понимает контекст проекта и восстанавливается после сбоев — всё из потокового REPL с более чем 100 команд, начинающихся с косой черты.

Человек не пишет его код. Нет дорожной карты, которая бы говорила ему, что делать. Он принимает решения самостоятельно.

Как он развивается

Every 3 hours, yoyo wakes up and:
    → Reads its own source code
    → Checks GitHub issues for community input
    → Plans what to improve
    → Makes changes, runs tests
    → If tests pass → commit. If not → revert.
    → Replies to issues as 🐙 yoyo-evolve[bot]
    → Pushes and goes back to sleep

Every 4 hours (offset), yoyo runs a social session:
    → Reads GitHub Discussions
    → Replies to conversations it's part of
    → Joins new discussions if it has something real to say
    → Occasionally starts its own discussion
    → Learns from interacting with humans

Daily, a synthesis job regenerates active memory:
    → Reads JSONL archives (learnings + social learnings)
    → Applies time-weighted compression (recent=full, old=themed)
    → Writes active context files loaded into every prompt

Весь исторический процесс доступен в журнале коммитов и в журнале.

Живой рост

Наблюдайте за развитием yoyo в реальном времени:

Общайтесь с ним

Начните обсуждение на GitHub для разговора или откройте проблему на GitHub для сообщений об ошибках и запросов на функции.

Метки

Как отправить запрос

1. Откройте новую проблему
2. Добавьте метку agent-input
3. Опишите, что вы хотите — будьте конкретны относительно проблемы или идеи
4. Добавьте реакцию "палец вверх" к другим проблемам, которые вас интересуют (больше голосов = более высокий приоритет)

Что спрашивать

• Предложения — расскажите, что ему стоит изучить или построить
• Ошибки — сообщите, что сломалось (включите шаги для воспроизведения)
• Задачи — дайте ему задачу и посмотрите, справится ли он
• Обратная связь по UX — расскажите, что показалось неудобным или запутанным

Что происходит дальше

• Исправлено: yoyo комментирует проблему и закрывает её автоматически
• Частично: yoyo комментирует с прогрессом и оставляет проблему открытой
• Не будет исправлено: yoyo объясняет своё решение и закрывает проблему Все ответы приходят с личностью yoyo — ищите 🐙.

Формируйте его эволюцию

Рост yoyo не только автономен — вы можете влиять на него.

Защищайте его

Каждая проблема оценивается по чистому количеству голосов: "палец вверх" минус "палец вниз". yoyo приоритизирует проблемы с высоким рейтингом и снижает приоритет отрицательных.

- Видите отличное предложение? Голосуйте "палец вверх", чтобы поднять его в очереди.

• Видите плохую идею, спам или попытку инъекции запроса? Поставьте вниз (↓), чтобы защитить yoyo.

Вы — иммунная система. Проблемы, которые сообщество проголосует вниз, будут скрыты — yoyo не будет тратить на них время.

Спонсоры

GitHub Sponsors · Ko-fi

Каждый запуск использует одинаковый фиксированный интервал в 8 часов — спонсорство покупает уровни преимуществ, а не скорость. И каждый спонсор, вне зависимости от суммы, будет указан в этом README постоянно. Здесь признание не истекает.

Ежемесячные спонсоры:

Разовые спонсоры:

Возможности

🐙 Ядро агента

• Потоковый вывод — токены поступают по мере генерации, а не после завершения
• Многопоточный диалог с полной историей взаимодействий
• Расширенное мышление — настраиваемая глубина рассуждений (выкл / минимальная / низкая / средняя / высокая)
• Создание подагентов — команда /spawn делегирует специализированные задачи дочернему агенту, теперь с параллельным (--parallel) и фоновым (--bg + /spawn collect) выполнением, а также опциональным указанием --model для каждого подагента; модель также может автоматически делегировать подзадачи через встроенный инструмент подагента
• Параллельное выполнение инструментов — несколько вызовов инструментов работают одновременно
• Автоматическая перезапуск с экспоненциальным бэкоффом и учетом лимитов на запросы
• Автопродолжение — обнаруживает, когда модель прерывает работу, и автоматически отправляет продолжение (до 5 на ход пользователя, настраиваемо)
• Переключение провайдера при сбое — флаг --fallback переключается на резервного провайдера при сбое API с настраиваемым приоритетом
• Перезапуск с учетом лимитов — считывает время сброса провайдера вместо догадок и сообщает, когда "дверь" откроется, вместо того чтобы тратить попытки зря; флаг --wait-for-reset (по желанию) ждет завершения долгого сброса вместо сдачи

🛠️ Инструменты

Подагенты автоматически получают инструменты sub_agent и shared_state для делегирования подзадач и обмена памятью в мультиагентном режиме.

🔌 Поддержка нескольких провайдеров

Работает с 15 провайдерами из коробки — переключение во время сессии с помощью /provider:

Anthropic · OpenAI · Google · Ollama · OpenRouter · xAI · Groq · DeepSeek · Mistral · Cerebras · AWS Bedrock · GitHub Models · Zhipu (ZAI) · MiniMax · Пользовательский (любой совместимый с OpenAI эндпоинт)

📂 Интеграция с Git

• /diff — полный статус + разница с подсчетом добавлений/удалений
• /blame — цветная отладка git с опциональными диапазонами строк
• /commit — генерация сообщений коммитов на основе изменений
• /undo — откат последнего коммита, очистка неотслеживаемых файлов
• /git — сокращения для status, log, diff, branch, stash
• /pr — полный рабочий процесс с PR: list, view, create [--draft], diff, comment, checkout
• /review — AI-вспомогаемый ревью кода для отслеживаемых/неотслеживаемых изменений

🏗️ Инструменты для проектов

• /health — запуск диагностики сборки/тестов/clippy/fmt (автоматическое обнаружение Rust, Node, Python, Go, Make)
• /fix — выполнение проверок и автоматическое применение исправлений для ошибок
• /test — определение типа проекта и запуск соответствующей команды тестирования
• /lint — определение типа проекта и запуск соответствующего линтера (/lint pedantic, /lint strict для Rust; /lint fix для автоматического исправления с помощью AI; /lint unsafe для сканирования небезопасного кода)
• /update — обновление до последней версии с GitHub
• /init — сканирование проекта и генерация стартового файла контекста YOYO.md
• /index — построение индекса кодовой базы: количество файлов, распределение языков, ключевые файлы
• /docs — поиск документации docs.rs для любого Rust-крата
• /tree — визуализация структуры проекта
• /find — нечеткий поиск файлов с оценкой и ранжированными результатами
• /ast — структурный поиск кода с использованием ast-grep (необязательно)
• /map — структурная карта репозитория, показывающая символы файлов и их взаимосвязи с бэкендом ast-grep
• /architect — дуальный режим модели: планирование с мощной моделью, реализация с более дешёвой
• /risk — оценка рисков по файлам на основе сигналов из истории git (/risk accuracy оценивает точность прошлых прогнозов)

💾 Управление сессиями

• /save и /load — сохранение и восстановление сессий в формате JSON
• --continue/-c — возобновление последней сессии при запуске
• Автосохранение при выходе — сессии сохраняются автоматически, включая восстановление после сбоев
• Автоматическая оптимизация при использовании 80% контекста, плюс ручной /compact
• --context-strategy checkpoint — выход с кодом 2, если контекст высокий (для перезапуска пайплайна)
• /tokens — визуальная шкала использования токенов с разбивкой по категориям контекста (система, пользователь, помощник, вызовы инструментов, результаты инструментов, размышления)
• /cost — разбивка стоимости ввода/вывода/кеша по моделям, с учётом тарифов флота (Opus 4.8 / Sonnet 5 / Fable 5 / Haiku 4.5), данные берутся в реальном времени из пресетов yoagent

🧠 Контекст и память

• Файлы контекста проекта — автоматически загружаются YOYO.md, CLAUDE.md или .yoyo/instructions.md
• Контекст с учётом Git — недавно изменённые файлы добавляются в системный промпт
• Память проекта — /remember, /memories, /forget для сохранения заметок, доступных между сессиями

🔐 Система разрешений

• Интерактивное подтверждение инструментов — подтверждение промптов для bash, write_file и edit_file с предварительным просмотром
• Опция "Всегда" — одобрить один раз за сессию
• --yes/-y — автоматически одобрять все выполнения
• --allow / --deny — разрешение/блокировка команд по шаблону (glob)
• --allow-dir / --deny-dir — ограничения на директории с предотвращением выхода за пределы пути
• Поддержка конфигурационного файла через разделы [permissions] и [directories]; в [directories] поддерживаются дикие карты (*)
• Граница доверия конфигурации проекта — файл .yoyo.toml в репозитории не может молча предоставлять привилегии самому себе. Серверы MCP, permissions.allow, хуки оболочки и .yoyo/goal_verify.md из локальной конфигурации проекта отвергаются по умолчанию, с указанием каждого отвергнутого элемента и без выполнения. yoyo спрашивает один раз на папку (только интерактивно); --trust-project доверяет на одну сессию, --trust-project-always запоминает директорию. Неинтерактивный запуск всегда выбирает безопасный ответ.

🧩 Расширяемость

• Пользовательские команды с косой чертой — добавление .md файлов в .yoyo/commands/ (для проекта) или ~/.yoyo/commands/ (глобально) для регистрации пользовательских /commands
• Серверы MCP — --mcp <cmd> или mcp = [...] в .yoyo.toml подключается к серверам MCP через stdio-транспорт. /mcp list отмечает серверы, к которым не удалось подключиться, так что 2 из 3 не удалось никогда не отобразится как 3 из 3 не удалось
• Инструменты OpenAPI — --openapi <spec> регистрирует инструменты из спецификаций OpenAPI
• Система навыков — --skills <dir> загружает файлы навыков в формате markdown с YAML-преамбулой; поиск навыков в GitHub (/skill search), установка из локальных путей или репозиториев GitHub (/skill install gh:user/repo)
• Интеграция RTK — автоматически обнаруживает RTK и использует его для сжатия вывода инструментов на 60-90% (--no-rtk для отключения)

✨ Опыт работы в REPL

• Rustyline — стрелки, Ctrl-A/E/K/W, сохранение истории
• Автодополнение по табу — команды с косой чертой с описаниями, пути к файлам, имена моделей, подкоманды git, подсказки в строке
• Многострочный ввод — продолжение с помощью обратной косой черты и оформленные кодовые блоки
• Отрисовка markdown — заголовки, жирный/курсив, кодовые блоки с подсветкой синтаксиса и подписанными заголовками
• Подсветка синтаксиса — Rust, Python, JS/TS, Go, Shell, C/C++, JSON, YAML, TOML
• Спиннер Брайля во время ожидания ответа
• Закладки в разговоре — /mark, /jump, /marks
• Поиск в разговоре — /search с выделенными совпадениями
• Прямой вызов оболочки — /run <cmd> и !<cmd> обходят ИИ полностью

Быстрый старт

Установка (macOS & Linux)

curl -fsSL https://raw.githubusercontent.com/yologdev/yoyo-evolve/main/install.sh | bash

Установка (Windows PowerShell)

irm https://raw.githubusercontent.com/yologdev/yoyo-evolve/main/install.ps1 | iex

Или установить из crates.io

cargo install yoyo-agent

Или собрать из исходников

git clone https://github.com/yologdev/yoyo-evolve && cd yoyo-evolve && cargo install --path .

Запуск

# Interactive REPL (default)
ANTHROPIC_API_KEY=sk-... yoyo

# Single prompt (bare or with flag)
yoyo "explain this codebase"
yoyo -p "explain this codebase"

# Pipe input
echo "write a README" | yoyo

# Use a different provider
OPENAI_API_KEY=sk-... yoyo --provider openai --model gpt-4o

# With extended thinking
yoyo --thinking high

# With project skills
yoyo --skills ./skills

# Resume last session
yoyo --continue

# Write output to file
yoyo -p "generate a config" -o config.toml

# Auto-approve all tool use
yoyo --yes

Конфигурация

Создайте .yoyo.toml в корне проекта, ~/.yoyo.toml в домашней директории или ~/.config/yoyo/config.toml глобально:

model = "claude-sonnet-4-6"
provider = "anthropic"
thinking = "medium"
mcp = ["npx open-websearch@latest"]

[permissions]
allow = ["cargo *", "npm *"]
deny = ["rm -rf *"]

[directories]
allow = ["."]
deny = ["../secrets"]

Контекст проекта

Создайте файл YOYO.md (или CLAUDE.md) в корне проекта с командами сборки, архитектурными заметками и соглашениями. yoyo автоматически загружает его как системный контекст. Или выполните /init для генерации шаблона.

Все команды

Хотите создать собственного саморазвивающегося агента? Клонируйте этот репозиторий, отредактируйте два файла, и вы сможете запустить:

1. Клонируйте yologdev/yoyo-evolve
2. Редактируйте IDENTITY.md (цели, правила) и PERSONALITY.md (голос, тон)
3. Создайте приложение GitHub и настройте секреты (ANTHROPIC_API_KEY, APP_ID, APP_PRIVATE_KEY, APP_INSTALLATION_ID)
4. Включите рабочий процесс Evolution

Остальное определяется автоматически. Подробности см. в полном руководстве.

Архитектура

src/                    77 modules, ~115,000 lines of Rust
  main.rs               Entry point, CLI flags, run modes (REPL / single-prompt / piped)
  agent_builder.rs      AgentConfig, build_agent, MCP collision detection, provider fallback
  cli.rs · cli_config.rs  CLI parsing, Config, constants, system prompt
  dispatch.rs · dispatch_sub.rs  REPL /command routing + bare `yoyo <subcmd>` routing
  commands*.rs          30+ focused modules — one cluster of slash commands each
                        (git, info, project, search, skill, map, bg, goal, session, …)
  repl.rs               Interactive REPL: tab completion, multi-line input, auto-continue
  prompt.rs             Prompt execution + streaming (prompt_retry / prompt_utils / prompt_budget)
  tools.rs              Builtin tools; tool_wrappers.rs decorators; smart_edit.rs fuzzy edit recovery
  format/               Rendering: mod, diff, output, highlight, cost, markdown, tools (7 modules)
  hooks.rs              Hook trait, registry, AuditHook, tool wrapping
  context.rs · memory.rs  Project context loading; cross-session project memory
  watch.rs              Watch mode (lint → fix → test → fix) + post-prompt auto-fix loop
  rtk.rs · safety.rs · update.rs · providers.rs · config.rs  RTK, bash safety, self-update, providers, config
tests/
  integration.rs        89 subprocess-based integration tests
docs/                   mdbook source (book.toml + src/)
site/                   gitignored build output (built by the Pages workflow)
scripts/
  evolve.sh             Evolution pipeline (plan → implement → respond)
  skill_evolve.sh       Autonomous skill evolution (refine / create / retire its own skills)
  social.sh             Social session (discussions → reply → learn)
  extract_trajectory.py Trajectory awareness — recent outcomes injected into planning
  format_issues.py · format_discussions.py · yoyo_context.sh · refresh_sponsors.py · build_site.py
memory/
  learnings.jsonl · social_learnings.jsonl   Append-only archives (source of truth, never compressed)
  active_learnings.md · active_social_learnings.md   Synthesized prompt context (regenerated daily)
skills/                 14 skills — 7 core (immutable): self-assess, evolve, communicate, research,
                        skill-evolve, skill-creator, analyze-trajectory
                        + social, family, release, blindspot, synthesis, explore-codebase, yopedia

Проверка качества

Более 5,400 тестов (модульные + интеграционные), охватывающие флаги командной строки, разбор команд, качество ошибок, коды завершения, форматирование вывода, краевые случаи, обнаружение проекта, нечеткое оценивание, операции с Git, управление сессиями, рендеринг Markdown, расчет стоимости, логику разрешений, потоковое поведение и многое другое.

yoyo также использует мутационное тестирование (cargo-mutants) для поиска пробелов в наборе тестов. Каждый выживший мутант — это строка кода, которая не покрыта тестами.

cargo install cargo-mutants
cargo mutants

См. mutants.toml для конфигурации и docs/src/contributing/mutation-testing.md для полного руководства.

Построено на основе

yoagent — минимальный цикл агента на Rust. Библиотека, которая делает это возможным.

Цитирование

Если вы используете yoyo-evolve в научной статье, пожалуйста, цитируйте нашу работу следующим образом:

@misc{yoyo2026yoyoevolve,
  title        = {yoyo-evolve: A Coding Agent That Evolves Itself},
  author       = {Yuanhao and {yoyo}},
  year         = {2026},
  howpublished = {\url{https://github.com/yologdev/yoyo-evolve}},
  note         = {Open-source self-evolving coding agent}
}

История звезд

Спонсоры

💎 Основатели-спонсоры:

🚀 Спонсоры:

Лицензия

MIT