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.
Обязательный порядок
- Определить, что текущая среда — Termux (
$PREFIX,pkg,apt-get). В другой среде завершить работу. - Найти доступные обновления через поддерживаемые менеджеры и показать пользователю список.
- Показать Termux-рекомендации и риски.
- Запросить явное разрешение. Без интерактивного подтверждения ничего не обновлять.
- Для найденных pip-пакетов запросить отдельное подтверждение: pip может перезаписать пакеты, которыми управляет
pkg. - Выполнить согласованные обновления пакетов и менеджеров.
- После обновления строго следовать регламенту
termux-fix-path:- Проверить наличие перехватывающих обёрток в
~/.local/bin/для обновленных системных пакетов из$PREFIX/bin(Модуль 7termux-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 успешного запуска.
- Проверить наличие перехватывающих обёрток в
Поддерживаемые источники обновлений
Скилл не привязан к фиксированному набору приложений: он сначала обнаруживает доступные менеджеры и применяет только подходящий для найденного источника.
- Termux
pkg/apt: системные и установленные из репозиториев Termux-пакеты. - Глобальный NPM: глобальные Node.js-приложения и модули, включая Codex CLI.
- Python/pip: устаревшие Python-пакеты, если
pipустановлен. - uv: установленные через
uv toolприложения и утилиты агентов (включая утилиту аудита безопасностиskillspector/ NVIDIA SkillSpector). - Self-updater приложения: поддержанные отдельные обновляторы, например
agy update.
Приложения, установленные standalone-архивом, Linux-бинарником, APK или неизвестным
установщиком, не обновляются угадыванием. Скилл показывает предупреждение и требует
отдельного адаптера/команды. Это сохраняет универсальность без опасного
update-everything.
Что обновляется:
- Пакеты Termux: После подтверждения выполняются
apt-get updateиapt-get upgradeв неинтерактивном режиме с сохранением существующих конфигов. - NPM модули и Codex CLI: обновляются глобальные NPM-пакеты, включая
@mmmbuto/codex-cli-termux. - Python/pip и uv tools: обновляются только обнаруженные устаревшие пакеты/инструменты; pip требует отдельного подтверждения из-за риска конфликта с
pkg. Для uv tools используется изолированное обновление черезuv tool upgrade --allили точечный вызов для конкретного инструмента. - Claude Code: пакет
@anthropic-ai/claude-codeисключается изnpm update -gи не переустанавливается. - Antigravity CLI: после общего разрешения запускается
agy update; самagyдополнительно проверяет доступность новой версии и спрашивает перед применением. - 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:
- Цепочка проверки:
launcher→runtime→ELF→shebang→glibc-runner→очистка устаревших обёрток в ~/.local/bin/→валидация запуска. - Очистка устаревших обёрток (Модуль 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.
- При обновлении пакетов через
- Изолированное хранение бэкапов:
- Все резервные копии и старые лаунчеры сохранять строго в
~/.local/state/backups/. - Категорически запрещено оставлять бэкапы или архивы прямо в
~/.local/bin/или других папках из$PATH.
- Все резервные копии и старые лаунчеры сохранять строго в
- Обработка shebang (Модуль 2
termux-fix-path):- Обрабатывать все текстовые скрипты-лаунчеры в
$(npm prefix -g)/binи внутренние бинарники модулей. - Никогда не применять
termux-fix-shebangк ELF-бинарникам.
- Обрабатывать все текстовые скрипты-лаунчеры в
- Валидация запуска:
- Проверять запуск (
--version/--help) только у доверенных установленных программ (codex,agy,skillspector).
- Проверять запуск (
Безопасное восстановление при сбоях (Модуль 9 termux-fix-path)
Если после обновления CLI или пакет перестает запускаться:
- Категорический запрет: не запускать повторное массовое обновление «вслепую», не удалять
$PREFIXи не переустанавливать среду Termux. - Порядок восстановления по Модулю 9:
- Зафиксировать ошибку из лога (
/tmp/auto_update_*.log), выводcommand -v,file,readlink -fиreadelf -l(PT_INTERP). - Определить, какой файл обновился и какому менеджеру/пакету он принадлежит.
- Восстановить файл из проверенного бэкапа в
~/.local/state/backups/либо через штатную переустановку пакета (pkg reinstall <пакет>). - Для текстовых launcher применить
termux-fix-shebang. - Для glibc приложений (например,
agy) проверить доступностьglibc-runnerи предложить переустановку glibc (pkg reinstall -y glibc). - Провести проверку запуска доверенного CLI (
--version/--help). - Сообщить пользователю путь к бэкапу, результат восстановления и остаточные ограничения.
- Зафиксировать ошибку из лога (
Скрипт
~/.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):
- Триггер: При первом сообщении сессии (
invocationNum == 1), если с момента последнего обновления и последнего напоминания прошло более 24 часов (86400 сек), хук генерирует эфемерную инструкцию для Оркестратора и фиксируетlast_prompt.timestamp. - Оркестрация: Оркестратор немедленно делегирует задачу Модулю/субагенту (
invoke_subagentс типомselfв фоновом режиме), а Пользователю в основном диалоге кратко сообщает, что запущен фоновый автоапдейт, не прерывая беседу. - Безопасное выполнение: Субагент выполняет обновление через
scripts/update_all.sh --auto(или последовательные команды):- Обновление системных пакетов Termux (
apt-get update && apt-get upgrade); - Проверка и архивация перехватывающих обёрток в
~/.local/bin/(Модуль 7termux-fix-path); - Обновление глобальных NPM пакетов с исключением Claude Code и восстановлением Termux shebang (
termux-fix-shebang); - Обновление инструментов uv (
uv tool upgrade --all/skillspector); - Обновление
agy(agy update); - Пакеты Python/pip в авто-режиме пропускаются по умолчанию во избежание конфликтов с
pkg.
- Обновление системных пакетов Termux (
- Конфликты и вопросы: Если при обновлении возникают конфликты версий, ошибки зависимостей или неоднозначности — субагент запрашивает решение у пользователя.
- Таймстемпы и защита от спама:
- При срабатывании хука фиксируется
last_prompt.timestamp, что блокирует повторный вызов на 24 часа даже при падении или отмене. - При успешном завершении (
ERRORS == 0) обновляетсяlast_update.timestampкак локально (~/.agents/skills/auto-updater/), так и во внешней памяти (/sdcard/.EasyCode/skills/auto-updater/).
- При срабатывании хука фиксируется
- Отчёт: По завершении субагент возвращает сжатый отчёт по стандарту: 📌 Изменения | 📁 Затронутые файлы | ⚠️ Риски | 🔗 Ссылки.
Связанные статьи 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)
Ссылки
- Antigravity CLI (Termux port): https://github.com/wallentx/antigravity-cli-termux
- NVIDIA SkillSpector: https://github.com/NVIDIA/SkillSpector
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 469k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |