Skip to content

Eniggman/termux-lab / auto-updater

auto-updater

Verified

Универсальная безопасная проверка и обновление приложений и пакетов в Termux по стандартам termux-fix-path. Claude Code намеренно исключён.

Auto Updater

Если приложение не удаётся классифицировать или после обновления нужен ремонт окружения, используй termux-fix-path. Скилл auto-updater отвечает за обнаружение доступных обновлений и инициацию процесса, но при выполнении обновлений и после них ОБЯЗАН строго следовать стандартам termux-fix-path (цепочка: launcher → runtime → ELF → shebang → glibc-runner → очистка устаревших обёрток в ~/.local/bin/ → валидация запуска).

Этот скилл содержит скрипт и инструкции для безопасного обновления приложений и пакетов именно в Termux/Android.

Скилл не должен запускаться как обычный Linux-скрипт: Termux использует Android/Bionic, а не стандартный Linux/glibc.

Обязательный порядок

  1. Определить, что текущая среда — Termux ($PREFIX, pkg, apt-get). В другой среде завершить работу.
  2. Найти доступные обновления через поддерживаемые менеджеры и показать пользователю список.
  3. Показать Termux-рекомендации и риски.
  4. Запросить явное разрешение. Без интерактивного подтверждения ничего не обновлять.
  5. Для найденных pip-пакетов запросить отдельное подтверждение: pip может перезаписать пакеты, которыми управляет pkg.
  6. Выполнить согласованные обновления пакетов и менеджеров.
  7. После обновления строго следовать регламенту termux-fix-path:
    • Проверить наличие перехватывающих обёрток в ~/.local/bin/ для обновленных системных пакетов из $PREFIX/bin (Модуль 7 termux-fix-path), деактивировать их с архивацией в ~/.local/state/backups/ и сбросить кэш hash -r;
    • Восстановить Termux shebang (termux-fix-shebang) для всех глобальных CLI в $(npm prefix -g)/bin (только для текстовых скриптов, никогда для ELF);
    • Проверить цепочку launcher → runtime → ELF → glibc-runner;
    • Проверить валидацию запуска (--version / --help) доверенных CLI;
    • При сбоях — следовать регламенту безопасного восстановления по Модулю 9 termux-fix-path;
    • Только при полном отсутствии ошибок (ERRORS == 0) записать timestamp успешного запуска.

Поддерживаемые источники обновлений

Скилл не привязан к фиксированному набору приложений: он сначала обнаруживает доступные менеджеры и применяет только подходящий для найденного источника.

  1. Termux pkg/apt: системные и установленные из репозиториев Termux-пакеты.
  2. Глобальный NPM: глобальные Node.js-приложения и модули, включая Codex CLI.
  3. Python/pip: устаревшие Python-пакеты, если pip установлен.
  4. uv: установленные через uv tool приложения и утилиты агентов (включая утилиту аудита безопасности skillspector / NVIDIA SkillSpector).
  5. Self-updater приложения: поддержанные отдельные обновляторы, например agy update.

Приложения, установленные standalone-архивом, Linux-бинарником, APK или неизвестным установщиком, не обновляются угадыванием. Скилл показывает предупреждение и требует отдельного адаптера/команды. Это сохраняет универсальность без опасного update-everything.

Что обновляется:

  1. Пакеты Termux: После подтверждения выполняются apt-get update и apt-get upgrade в неинтерактивном режиме с сохранением существующих конфигов.
  2. NPM модули и Codex CLI: обновляются глобальные NPM-пакеты, включая @mmmbuto/codex-cli-termux.
  3. Python/pip и uv tools: обновляются только обнаруженные устаревшие пакеты/инструменты; pip требует отдельного подтверждения из-за риска конфликта с pkg. Для uv tools используется изолированное обновление через uv tool upgrade --all или точечный вызов для конкретного инструмента.
  4. Claude Code: пакет @anthropic-ai/claude-code исключается из npm update -g и не переустанавливается.
  5. Antigravity CLI: после общего разрешения запускается agy update; сам agy дополнительно проверяет доступность новой версии и спрашивает перед применением.
  6. SkillSpector (NVIDIA SkillSpector): утилита аудита безопасности AI-навыков, установленная в изолированном окружении uv (uv tool). Проверяется наличие (uv tool list или command -v skillspector) и обновляется безопасной командой uv tool upgrade skillspector (или в общем потоке uv tool upgrade --all). Поскольку инструмент изолирован в собственном виртуальном окружении uv, процедура не затрагивает системный Python Termux и библиотеки $PREFIX.

Termux-совместимость

  • Нативные Termux-пакеты устанавливаются через pkg/apt, а не через Linux-установщики.
  • Обычные glibc-бинарники Android напрямую не запускает. Для них нужен glibc-runner; наличие runner’а проверяется до обновления.
  • Если приложению нужен glibc, рекомендуемый Termux-путь: подключить glibc-repo, установить glibc, затем запускать бинарник через glibc-runner. Это отдельная операция и не выполняется автоматически.
  • В Termux нет /usr/bin/env в обычном Linux-смысле. После обновления NPM CLI скилл запускает termux-fix-shebang для всех установленных глобальных CLI в $(npm prefix -g)/bin (только для текстовых скриптов, никогда для ELF).
  • Если agy падает после обновления, скилл только показывает рекомендацию pkg reinstall -y glibc; сам ремонт без отдельного подтверждения не выполняется.
  • Инструменты uv tool (включая skillspector) изолированы в ~/.local/share/uv/tools/ с точками входа в ~/.local/bin/. Обновление через uv tool upgrade skillspector безопасно для системного Python и не ломает Bionic-окружение Termux.
  • Переустановка пакетов, исправление shebang’ов и обновление приложений — разные действия; согласие на одно не следует молча распространять на другие.

Регламент интеграции с termux-fix-path

auto-updater отвечает за обнаружение доступных обновлений и инициацию процесса, но при выполнении обновлений и после них ОБЯЗАН строго следовать стандартам termux-fix-path:

  1. Цепочка проверки: launcher → runtime → ELF → shebang → glibc-runner → очистка устаревших обёрток в ~/.local/bin/ → валидация запуска.
  2. Очистка устаревших обёрток (Модуль 7 termux-fix-path):
    • При обновлении пакетов через pkg/apt проверить системный PATH: доступна ли нативная версия в $PREFIX/bin/$APP.
    • Если в ~/.local/bin/$APP находится старый launcher/wrapper, он может перехватывать вызов из-за приоритета ~/.local/bin в $PATH.
    • Проверить прямой запуск $PREFIX/bin/$APP --version (или --help). Если нативная версия работает штатно, деактивировать устаревшую обёртку перемещением в ~/.local/state/backups/ и сбросить кэш оболочки hash -r.
  3. Изолированное хранение бэкапов:
    • Все резервные копии и старые лаунчеры сохранять строго в ~/.local/state/backups/.
    • Категорически запрещено оставлять бэкапы или архивы прямо в ~/.local/bin/ или других папках из $PATH.
  4. Обработка shebang (Модуль 2 termux-fix-path):
    • Обрабатывать все текстовые скрипты-лаунчеры в $(npm prefix -g)/bin и внутренние бинарники модулей.
    • Никогда не применять termux-fix-shebang к ELF-бинарникам.
  5. Валидация запуска:
    • Проверять запуск (--version / --help) только у доверенных установленных программ (codex, agy, skillspector).

Безопасное восстановление при сбоях (Модуль 9 termux-fix-path)

Если после обновления CLI или пакет перестает запускаться:

  • Категорический запрет: не запускать повторное массовое обновление «вслепую», не удалять $PREFIX и не переустанавливать среду Termux.
  • Порядок восстановления по Модулю 9:
    1. Зафиксировать ошибку из лога (/tmp/auto_update_*.log), вывод command -v, file, readlink -f и readelf -l (PT_INTERP).
    2. Определить, какой файл обновился и какому менеджеру/пакету он принадлежит.
    3. Восстановить файл из проверенного бэкапа в ~/.local/state/backups/ либо через штатную переустановку пакета (pkg reinstall <пакет>).
    4. Для текстовых launcher применить termux-fix-shebang.
    5. Для glibc приложений (например, agy) проверить доступность glibc-runner и предложить переустановку glibc (pkg reinstall -y glibc).
    6. Провести проверку запуска доверенного CLI (--version / --help).
    7. Сообщить пользователю путь к бэкапу, результат восстановления и остаточные ограничения.

Скрипт

~/.agents/skills/auto-updater/scripts/update_all.sh

Скрипт проверяет файл last_update.timestamp в папке скилла. Если с момента последнего успешного обновления прошло менее 24 часов (86400 сек), скрипт досрочно завершается со статусом UPDATE_SKIPPED, чтобы не выполнять лишние операции. Если обновление запускается, скрипт собирает логи в /tmp/auto_update_<дата>.log и возвращает UPDATE_SUCCESS (перезаписывая timestamp) или UPDATE_FAILED.

Автоматизация и Режимы работы

Интерактивный режим (по запросу)

Пользователь может вручную вызвать скилл auto-updater или скрипт update_all.sh. При ручном запуске запрашивается явное подтверждение каждого шага.

Автоматический фоновый режим (Вариант 3 — выбор пользователя)

Настроен автоматический ежедневный цикл через PreInvocation хук Antigravity CLI (.agents/hooks.json -> scripts/hook_check.py):

  1. Триггер: При первом сообщении сессии (invocationNum == 1), если с момента последнего обновления и последнего напоминания прошло более 24 часов (86400 сек), хук генерирует эфемерную инструкцию для Оркестратора и фиксирует last_prompt.timestamp.
  2. Оркестрация: Оркестратор немедленно делегирует задачу Модулю/субагенту (invoke_subagent с типом self в фоновом режиме), а Пользователю в основном диалоге кратко сообщает, что запущен фоновый автоапдейт, не прерывая беседу.
  3. Безопасное выполнение: Субагент выполняет обновление через scripts/update_all.sh --auto (или последовательные команды):
    • Обновление системных пакетов Termux (apt-get update && apt-get upgrade);
    • Проверка и архивация перехватывающих обёрток в ~/.local/bin/ (Модуль 7 termux-fix-path);
    • Обновление глобальных NPM пакетов с исключением Claude Code и восстановлением Termux shebang (termux-fix-shebang);
    • Обновление инструментов uv (uv tool upgrade --all / skillspector);
    • Обновление agy (agy update);
    • Пакеты Python/pip в авто-режиме пропускаются по умолчанию во избежание конфликтов с pkg.
  4. Конфликты и вопросы: Если при обновлении возникают конфликты версий, ошибки зависимостей или неоднозначности — субагент запрашивает решение у пользователя.
  5. Таймстемпы и защита от спама:
    • При срабатывании хука фиксируется last_prompt.timestamp, что блокирует повторный вызов на 24 часа даже при падении или отмене.
    • При успешном завершении (ERRORS == 0) обновляется last_update.timestamp как локально (~/.agents/skills/auto-updater/), так и во внешней памяти (/sdcard/.EasyCode/skills/auto-updater/).
  6. Отчёт: По завершении субагент возвращает сжатый отчёт по стандарту: 📌 Изменения | 📁 Затронутые файлы | ⚠️ Риски | 🔗 Ссылки.

Связанные статьи Wiki

  • [[termux-fix-path]] — единый регламент установки, обновления и ремонта CLI в Termux
  • [[запуск-linux-приложений]] — Bionic, glibc и glibc-runner
  • [[agy-glibc-after-update]] — восстановление agy после сбоя glibc
  • [[codex-shebang-fix]] — исправление shebang Codex CLI в Termux
  • [[пакеты]] — репозитории и установка пакетов Termux
  • [[checker-skill-nvidia]] — аудит безопасности AI-навыков (NVIDIA SkillSpector)

Ссылки

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall