Mercury Agent — персональный ИИ-агент, который живёт на вашей машине

Mercury Agent — опенсорсный персональный ИИ-агент, который живёт на вашей машине как фоновый процесс. Он спрашивает разрешение перед действиями, помнит важное между разговорами и продолжает работать, когда вы закрыли ноутбук. Общаться с ним можно из терминала, Telegram, Discord, Slack, Signal и через локальную веб-панель — все каналы ведут к одному агенту с одной памятью.

Проект распространяется по лицензии MIT и ставится одной командой. Внутри — около пятидесяти встроенных инструментов: файлы, shell, git, GitHub, веб, планировщик, память и суб-агенты. Сверху можно ставить скиллы из каталога сообщества.

Чем Mercury отличается

Спрашивает перед действием. Доступ к файлам ограничен по папкам. Shell-команды проходят через блок-лист и подтверждение. Исходящие запросы проверяются на приватные адреса. Режим выбирается на сессию: спрашивать каждый раз или выполнять всё свободно. Участники общего чата в Telegram или Discord не могут расширить свои права.

Помнит без напоминаний. После каждого разговора Mercury извлекает несколько устойчивых фактов — предпочтения, цели, проекты, решения — с оценкой уверенности. Он сверяет их с тем, что уже знает, и поднимает нужные перед следующим ответом. Всё хранится в SQLite-файле в ~/.mercury. Команда /memory позволяет посмотреть, поставить на паузу или очистить память.

Уважает бюджет. Дневной лимит токенов проверяется на каждом ходе. Когда расход растёт, режим Token Saver урезает контекст и переводит рутинные задачи на более дешёвую модель. Команда /budget показывает остаток.

Один рантайм, а не набор скриптов. Один фоновый процесс владеет каналами, ботами и веб-панелью. Команда mercury в терминале мгновенно подключается к этому процессу. Поэтому закрытый терминал не останавливает задачу и не убивает ботов.

Характер пишете вы. Личность агента задана обычными Markdown-файлами: soul.md, persona.md, taste.md, heartbeat.md. Их можно править как угодно.

Установка

Установщик скачивает автономный бинарник под вашу систему и проверяет его контрольную сумму. Node.js не нужен.

# macOS / Linux
curl -fsSL https://mercuryagent.sh/install.sh | sh

# Windows (PowerShell)
irm https://mercuryagent.sh/install.ps1 | iex

Через npm тоже можно, но там нужен Node.js 22+:

npm i -g @cosmicstack/mercury-agent

Первый запуск открывает мастер настройки: ваше имя, имя агента, провайдер моделей, необязательные каналы вроде Telegram. Дальше Mercury ставит фоновую службу и открывает терминальный интерфейс.

mercury            # открыть чат (подключается к запущенному агенту)
mercury code .     # открыть Mercury Code в текущем репозитории
mercury doctor     # сменить провайдеров, ключи или каналы
mercury status     # посмотреть, что запущено

Обновление — одна команда: mercury upgrade.

Как это устроено

Рантайм работает как служба входа в систему: LaunchAgent на macOS, systemd на Linux, Task Scheduler на Windows. После сбоя он перезапускается сам. Каждый канал говорит с одним и тем же агентом, под теми же правами и с той же памятью. Терминал — просто клиент.

Модели: DeepSeek, OpenAI, Anthropic, Grok, Ollama (облако и локально), LM Studio, любой OpenAI-совместимый эндпоинт и Mercury Cloud. Провайдер по умолчанию пробуется первым, при сбое Mercury переключается на следующий. Ключ с ошибкой пропускается, пока вы его не замените.

Mercury Code

Режим для работы внутри репозитория. Запускается через mercury code [dir] из шелла или /code из чата.

• AUTO-режим: планирует и делает за один проход, перед крупными изменениями спрашивает один раз.
• Проверенное завершение: задача считается сделанной только после того, как сборка, тесты или typecheck прошли. Иначе Mercury останавливается и называет блокер.
• Живой план: каждый шаг виден как «ожидает», «выполняется» или «готово».
• Фоновая работа: /code agent <task> отдаёт задачу суб-агенту, пока вы продолжаете работать.
• Просмотр workspace: /ws — посмотреть, застейджить, закоммитить и откатить изменения; /code diff — цветной diff.

Mercury Bots

Bots — постоянные агенты-специалисты. Они работают рядом с основным агентом и не блокируют его. У каждого своя персона, модель, память, права и дневной бюджет.

• Создание через /bots create из терминала, Telegram или веб-панели.
• Команды (fleets): лид-бот раздаёт типизированные задачи своей команде, запускает пайплайны из bot.yaml и присылает одну сводку по итогам.
• Результаты: готовые файлы складываются в ~/Documents/Mercury/<имя бота>/. В Telegram они приходят вложениями.
• Управление: ростер /bots с кнопками Stop, Start и Run прямо в Telegram; /bots cost, /bots show, /bots doctor.

Second Brain — память на диске

• 10 типов памяти: личность, предпочтения, цели, проекты, привычки, решения, ограничения, связи, эпизоды, размышления.
• Автоматическое извлечение до трёх фактов за разговор с оценками уверенности, важности и долговечности.
• Перед каждым ответом поднимаются самые релевантные воспоминания — в пределах фиксированного бюджета.
• Каждый час проходит консолидация: память сворачивается в профиль и сводку текущего состояния, устаревшие и слабые факты вымирают.
• Всё локально: SQLite с полнотекстовым поиском в ~/.mercury/memory/second-brain/second-brain.db.

Безопасность

• Shell: блок-лист, который нельзя отключить (sudo, rm -rf / и варианты), плюс подтверждение всего за пределами разрешённых папок.
• Файлы: права на чтение и запись по папкам, каналам и ролям.
• Сеть: fetch_url блокирует приватные диапазоны адресов и ограничивает размер ответа.
• Секреты: ключи API лежат в ~/.mercury/.env, в логах они вырезаются, пароль веб-панели генерируется случайным при первом запуске.

Скиллы

Скиллы ставятся из каталога skills.mercuryagent.sh по спецификации Agent Skills:

mercury skills search prompt
mercury skills view ai-ml/prompt-engineering
mercury skills install ai-ml/prompt-engineering

Скиллы созданы сообществом и не проходят аудит, поэтому сначала читайте их через skills view.

Веб-панель и планировщик

Веб-панель живёт на http://127.0.0.1:6174 и привязана к localhost: чат, кокпит ботов, обозреватель памяти, провайдеры, права, расписания и расход токенов. Канбан-доски Mercury разбирает карточка за карточкой в порядке зависимостей. Планировщик запускает cron-задачи и разовые задержки, результаты уходят в канал, который задачу создал.

Итог

Mercury — попытка сделать агента, который живёт у вас дома: одна служба, ваши правила, ваша память на вашем диске и ваш характер в Markdown-файлах. Если нужен не «помощник в редакторе», а постоянный цифровой коллега с доступом в Telegram, проект стоит попробовать. Документация — на mercuryagent.sh/docs.