yacli

CLI, MCP server и MCP Apps для Яндекс Почты, Календаря и Диска

Один аккуратный продуктовый интерфейс для терминала, ИИ-агентов и MCP-хостов.

Установка • Быстрый старт • Команды • Сценарии • MCP

yacli связывает Яндекс Почту, Календарь и Диск в один внятный интерфейс: в терминале, в агентских клиентах и внутри MCP Apps. Один бинарь закрывает повседневную ручную работу, агентские интеграции и составные сценарии вроде письмо → .ics → событие или файл → письмо.

Установка

macOS и Linux

curl -fsSL https://raw.githubusercontent.com/NextStat/yacli/main/scripts/install.sh | sh

Windows

irm https://raw.githubusercontent.com/NextStat/yacli/main/scripts/install.ps1 | iex

Готовые сборки для macOS x86_64/arm64, Linux x86_64/arm64 и Windows x86_64 лежат в GitHub Releases.

cargo install --path .                 # сборка из исходников
yacli update                           # обновить до последнего релиза
yacli update --check                   # проверить без установки

export YACLI_UPDATE_BASE_URL='https://mirror.example.test/releases/download/v0.5.5'
yacli update --check

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

Запуск за минуту

curl -fsSL https://raw.githubusercontent.com/NextStat/yacli/main/scripts/install.sh | sh
yacli setup [email protected] --calendar-app-password <пароль> --client claude

После этого у вас сразу будут:

• локальный CLI для Почты, Календаря и Диска;
• MCP server для Claude, Codex, Gemini и других клиентов;
• prompts, embedded skills, resources и dashboard для MCP Apps;
• готовые кросс-сервисные сценарии без клея из скриптов.
• live onboarding checklist в Unified Home, чтобы добить недостающие шаги без гадания.
• terminal home screen через yacli home, чтобы увидеть onboarding, workflows и последние действия в одном месте.
• product health-check через yacli doctor и resource://yacli/doctor, чтобы быстро понять, что ещё мешает readiness.
• safe remediation через yacli doctor --apply-safe и кнопку Apply safe fixes в Unified Home, чтобы автоматически закрыть безопасные локальные фиксы.
• ranked next actions через yacli next и resource://yacli/next-actions, чтобы сразу видеть самые выгодные следующие шаги.
• proactive suggestions через yacli suggest и resource://yacli/suggestions, чтобы получать recovery / cleanup / undo подсказки из реальной activity history и live product signals. В Unified Home эти suggestions теперь не только видны, но и ведут прямо в undo или канонический workflow/review path.
• workflow show и resource://yacli/workflow/{workflow} теперь отдают server-driven execution.state и execution.available_actions, чтобы CLI, MCP и Apps видели один и тот же actionable lifecycle workflow: needs_input, review_ready, ready, recovery_ready, undo_ready, applied, undone.
• Workflow panel в Apps теперь использует server-driven execution.actions для next action, так что connect / review / resume / cleanup / undo / replay идут из одного канонического workflow contract, а не из UI-эвристик.
• Для partial recovery execution.actions теперь по возможности несёт точный tool_name + tool_arguments, чтобы Apps могли открыть или применить retry-step без ручного прыжка в activity/replay shell command.

С чего начать

Для агентских и headless-сценариев yacli login теперь работает в два шага без ломкого stdin-диалога:

yacli login
# => status=pending, authorization_url, resume_command

yacli login --code <код>

yacli сохраняет pending PKCE session в локальном config dir и переиспользует её при втором вызове, поэтому код подтверждения больше не ломается из-за нового code_verifier.

export YACLI_CALENDAR_APP_PASSWORD='<пароль>'
yacli login calendar --env-var YACLI_CALENDAR_APP_PASSWORD

Проверьте, что всё работает

yacli home
yacli doctor
yacli doctor --apply-safe
yacli next
yacli suggest
yacli status
yacli mail list
yacli calendar calendars
yacli disk info

Живой сценарий в Claude Cowork

yacli уже тянет реальные составные задачи внутри агентского интерфейса, а не только отдельные команды.

Запрос в Claude Cowork:

Создай событие "Ревью yacli v0.5" понедельник в 11:00 на 30 минут, отправь напоминание на почту, и создай папку на Диске для материалов

Что получилось:

1. Событие создано в календаре на понедельник, 16 марта 2026, 11:00–11:30.
2. Напоминание на почту отправлено.
3. Папка на Яндекс Диске подтверждена: /yacli-v0.5-review.

Почему это важно: один запрос связывает сразу три surface yacli:

• календарь для создания события;
• почту для отправки напоминания;
• диск для подготовки рабочей папки.

Именно это и является продуктовой целью yacli: не просто “дать tools”, а довести реальные рабочие сценарии до одного понятного контракта для людей и агентов.

Повседневные команды

Почта

yacli mail folders
yacli mail list
yacli mail search "смета"
yacli mail read 1353
yacli mail reply 1353 "Принято, спасибо"
yacli mail forward 1353 [email protected] "Посмотрите, пожалуйста"
yacli mail send [email protected] "Синк" "Привет"
yacli mail send [email protected] "Счёт" "Во вложении файл" --attach ./invoice.pdf
yacli mail send [email protected] "Счёт" "Во вложении файл" --attach ./invoice.pdf --dry-run
yacli mail send-link [email protected] "Материалы" "Отправляю ссылку" --source ./archive.zip --path disk:/docs/archive/archive.zip
yacli mail send-link [email protected] "Материалы" "Отправляю ссылку" --source ./archive.zip --path disk:/docs/archive/archive.zip --dry-run
yacli mail send-published-link [email protected] "Материалы" "Отправляю ссылку" --public-url https://disk.yandex.ru/i/archive-link
yacli mail send-published-link [email protected] "Материалы" "Отправляю ссылку" --public-url https://disk.yandex.ru/i/archive-link --dry-run
yacli disk upload-link --source ./archive.zip --path disk:/docs/archive/archive.zip
yacli disk upload-link --source ./archive.zip --path disk:/docs/archive/archive.zip --dry-run

Вложения и приглашения:

yacli mail attachment export 1353 --index 1 --output ./invoice.pdf
yacli mail invite inspect 1353 --index 1
yacli mail invite create-event 1353 --index 1

• Число 1353 — идентификатор письма из mail list или mail search.
• --folder "Имя папки" для работы не с INBOX.
• --html, --cc, --bcc для HTML и копий.
• --attach можно указать несколько раз.
• --dry-run показывает review отправки без реального SMTP-вызова.
• Если собранное письмо уже слишком тяжёлое для безопасной SMTP-отправки, mail send --dry-run честно рекомендует workflow send-link-by-mail, а реальный mail send блокируется до сетевого шага с той же подсказкой.
• mail send-link — правильный flow для больших файлов: upload на Диск, publish ссылки и письмо со ссылкой в одном шаге.
• Если у mail send-link уже случился upload + publish, а SMTP упал, команда возвращает status=partial с готовыми recovery actions: повторить только mail-step через mail send-published-link, вручную поделиться ссылкой или отозвать её.
• mail send-published-link — честный retry mail-step для уже опубликованной ссылки без повторного upload/publish.
• disk upload-link — правильный flow, когда нужно просто получить публичную ссылку без отправки письма.

yacli mail list --folder "Отправленные" --limit 20
yacli mail search "договор" --folder "Архив 2026"
yacli mail attachment export 1353 --name invoice.pdf --output ./invoice.pdf
yacli mail invite inspect 1353 --name invite.ics
yacli mail invite create-event 1353 --name invite.ics --calendar team --event-index 2
yacli mail send [email protected] "Счет" "Отправляю счет" --cc [email protected]
yacli mail send [email protected] "Счет" "Отправляю счет" --attach ./invoice.pdf --attach ./spec.docx
yacli mail send-link [email protected] "Материалы" "Отправляю ссылку" --source ./archive.zip --path disk:/docs/archive/archive.zip

Календарь

yacli calendar calendars
yacli calendar events
yacli calendar events 2026-03-14 2026-03-20 --limit 20
yacli calendar create "Синк команды" 2026-03-14T09:00:00Z 2026-03-14T10:00:00Z
yacli calendar create "Синк команды" 2026-03-14T09:00:00Z 2026-03-14T10:00:00Z --dry-run
yacli calendar delete <id>

• Без дат events показывает ближайшие 30 дней.
• --calendar <id> для работы не с default-календарём.
• calendar create --dry-run показывает review события без реального CalDAV PUT.

Диск

yacli disk info
yacli disk list
yacli disk list disk:/docs --limit 50
yacli disk mkdir disk:/docs/archive
yacli disk upload ./report.pdf disk:/docs/archive/report.pdf
yacli disk upload ./report.pdf disk:/docs/archive/report.pdf --dry-run
yacli disk upload-link --source ./report.pdf --path disk:/docs/archive/report.pdf
yacli disk upload-link --source ./report.pdf --path disk:/docs/archive/report.pdf --dry-run
yacli disk download disk:/docs/archive/report.pdf --output ./report.pdf
yacli disk publish disk:/docs/archive/report.pdf
yacli disk publish disk:/docs/archive/report.pdf --dry-run
yacli disk unpublish disk:/docs/archive/report.pdf
yacli disk unpublish disk:/docs/archive/report.pdf --dry-run

• disk upload --dry-run показывает review файла и remote path без запроса upload ticket и без реальной загрузки.
• disk upload-link закрывает human flow локальный файл -> Диск -> публичная ссылка в одном шаге; --dry-run показывает review без upload/publish.
• disk download скачивает приватный файл с того же robust transfer contract: progress, retry, stats и activity replay.
• disk publish --dry-run показывает, что именно будет опубликовано и уже есть ли у ресурса public_url / public_key, без реального publish.
• disk publish публикует приватный ресурс и возвращает public_url / public_key, чтобы большой файл можно было не слать вложением, а отдать ссылкой.
• disk unpublish --dry-run показывает, какая публичная ссылка будет снята, без реального revoke.
• disk unpublish отзывает публичную ссылку и возвращает, какая public_url / public_key были сняты.
• Реальные upload/download transfer на Диск по умолчанию ждут завершения без общего short timeout на тело запроса; при необходимости жёсткий потолок можно задать через YACLI_DISK_UPLOAD_TIMEOUT_SECS и YACLI_DISK_DOWNLOAD_TIMEOUT_SECS.
• В CLI table-mode большие upload/download показывают живой progress и throughput в stderr, не ломая JSON/MCP contract.
• При transient сетевых сбоях transfer автоматически делает несколько безопасных retry-попыток: download стартует заново, upload получает новый upload ticket и повторяет отправку целиком.
• disk public download теперь умеет resumable download через .part + HTTP Range, если download endpoint поддерживает partial content; итоговый payload показывает resumed_from_bytes, attempts и elapsed_ms.

Журнал действий

yacli activity list
yacli activity list --limit 20
yacli activity show <id>
yacli activity undo <id>

• В журнал попадают только успешные реальные write-операции.
• --dry-run в журнал не записывается.
• У каждой записи есть replay_command, который можно повторить или передать агенту.
• Для честно обратимых действий запись дополнительно несёт undo_command, а yacli activity undo <id> выполняет штатный rollback.

Публичный Диск

yacli disk public show --public-key https://disk.yandex.ru/i/WhGpLnQWR9efCA
yacli disk public download --public-key https://disk.yandex.ru/i/WhGpLnQWR9efCA --output ./sample.pdf

Кросс-сервисные сценарии

# утренняя сводка
yacli mail list --limit 10
yacli calendar events

# ответ с учётом расписания
yacli mail read 1353
yacli calendar events 2026-03-14 2026-03-16
yacli mail reply 1353 "Подтверждаю, это окно подходит"

# большой файл -> ссылка -> письмо
yacli mail send-link [email protected] "Материалы" "Отправляю ссылку" --source ./archive.zip --path disk:/docs/archive/archive.zip

# локальный файл -> публичная ссылка
yacli disk upload-link --source ./archive.zip --path disk:/docs/archive/archive.zip

# отозвать публичную ссылку
yacli disk unpublish disk:/docs/archive/archive.zip

# сохранить вложение
yacli mail attachment export 1353 --name invoice.pdf --output ./invoice.pdf

# отправить файл по почте
yacli mail send [email protected] "Счёт" "Во вложении файл" --attach ./invoice.pdf

# приглашение → событие
yacli mail invite inspect 1353 --index 1
yacli mail invite create-event 1353 --index 1 --calendar team

Для MCP-клиентов те же сценарии доступны через prompts/get и resource://yacli/skill/*.

Несколько адресов

yacli add [email protected]
yacli login

yacli add [email protected] work
yacli use work
yacli login

yacli mail list --account personal
yacli mail search "счет" --account work

У каждого адреса свои токены и настройки. use переключает текущую учётную запись, --account обращается к конкретной.

Почему yacli

flowchart LR
    U["Пользователь / агент"] --> CLI["yacli CLI"]
    U --> MCP["yacli MCP server"]
    MCP --> APPS["MCP Apps dashboard"]
    MCP --> PROMPTS["prompts / skills / resources"]
    CLI --> MAIL["Яндекс Почта"]
    CLI --> CAL["Яндекс Календарь"]
    CLI --> DISK["Яндекс Диск"]
    MCP --> MAIL
    MCP --> CAL
    MCP --> DISK
    APPS --> MAIL
    APPS --> CAL
    APPS --> DISK

Важно: yacli не является продуктом Яндекса. Яндекс этот проект не поддерживает. Это самостоятельный проект с открытым исходным кодом.

MCP

Запуск

yacli mcp                                                    # stdio
yacli mcp --transport http --listen 127.0.0.1:8787           # HTTP

stdio автоматически совместим с Content-Length framing и line-delimited JSON — один бинарник работает и в старых, и в новых клиентах.

Установка в клиенты

yacli mcp install                          # все обнаруженные клиенты
yacli mcp install --client claude          # Claude Code + Claude Desktop
yacli mcp install --client codex           # Codex
yacli mcp install --client gemini          # Gemini CLI
yacli mcp install --client cursor          # Cursor

Регистрирует MCP server и раскладывает 13 embedded skills в клиентские каталоги.

Поддерживаемые клиенты: Claude Code, Claude Desktop / Cowork, Codex, Gemini CLI, Cursor, Zed, Windsurf, Antigravity, Warp.

Что получает MCP-клиент

export YACLI_MCP_HTTP_BEARER_TOKEN='secret-token'
yacli mcp --transport http --listen 127.0.0.1:8787

export YACLI_MCP_HTTP_AUTH_ISSUER='https://auth.example.test'

yacli mcp --transport http --listen 127.0.0.1:8787 --public-url https://mcp.example.test/mcp

yacli mcp install --client claude --transport http --url http://127.0.0.1:8787/mcp
yacli mcp install --client codex --transport http --url http://127.0.0.1:8787/mcp
yacli mcp install --client gemini --transport http --url http://127.0.0.1:8787/mcp

resource://yacli/account/{alias}
resource://yacli/auth/{alias}
resource://yacli/skills
resource://yacli/skill/{skill}
ui://yacli/dashboard{?account,section,resource,tool,skill,prompt}

Для автоматизации

По умолчанию yacli печатает JSON. Для табличного вывода:

yacli --format table mail list

Скрытая команда guide для агентских обвязок:

yacli guide
yacli guide --topic mail

Где лежат настройки

export YACLI_CONFIG_DIR=/path/to/config-dir   # переопределить каталог

Что ещё полезно знать

• status показывает, какие службы подключены у текущей учётной записи;
• если OAuth-токен Почты или Диска истёк, достаточно снова выполнить yacli login;
• mail forward пересылает письмо вместе с обычными вложениями и inline-файлами;
• disk public download не перезаписывает существующий файл без --force.

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

cargo build --workspace
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings