Skip to content

Eniggman/termux-lab / termux-api

termux-api

Unverified

Взаимодействие с Android OS и аппаратными датчиками смартфона через Termux:API (батарея, уведомления, буфер обмена, вибрация, диалоги, сенсоры, TTS).

Termux:API Integration Skill

Этот скилл содержит набор инструментов, утилит и регламентов для безопасного взаимодействия автономных ИИ-агентов (Antigravity CLI, OpenCode и др.) с операционной системой Android и аппаратными сенсорами через Termux:API.

Требования и окружение

  1. CLI-пакет: Установлен пакет termux-api (pkg install -y termux-api).
  2. Android Companion App: Установлено приложение-компаньон Termux:API из F-Droid или GitHub Releases (версии Termux и Termux:API должны быть подписаны одним ключом).
  3. Разрешения Android:
    • Доступ к уведомлениям;
    • Доступ к точной геолокации / камере / микрофону (если используются);
    • Отключение оптимизации батареи (Doze mode) для Termux и Termux:API.

Доступные скрипты и утилиты

Все вспомогательные скрипты находятся в scripts/:

СкриптНазначениеВызов
battery_check.shЧтение уровня заряда, температуры и статуса батареи./scripts/battery_check.sh [--json]
notify.shОтправка интерактивного системного Android Push-уведомления./scripts/notify.sh "Заголовок" "Текст" [id] [priority]
vibrate.shТактильный виброотклик (haptic feedback)./scripts/vibrate.sh [ms]
toast.shВсплывающее системное уведомление на экране (Toast)./scripts/toast.sh "Сообщение"
clipboard.shБезопасное чтение и запись системного буфера обмена Android./scripts/clipboard.sh [get|set "текст"]
dialog.shИнтерактивные системные GUI-диалоги (подтверждение, ввод)./scripts/dialog.sh [confirm|text] "Заголовок" "Подсказка"
sensor_read.shОднократный опрос датчиков (освещенность, акселерометр)./scripts/sensor_read.sh [list|sensor_name|all]
tts_speak.shГолосовое озвучивание статусов агента (Text-To-Speech)./scripts/tts_speak.sh "Текст"

Правила безопасности и ограничения Android

  1. Android 14 (API 34) Storage SAF:
    • Вызов termux-storage-get на Android 14 может молча возвращать 0 без вызова UI. Для чтения файлов используйте прямое обращение к /sdcard/ или SAF-команды termux-saf-*.
  2. Фоновые тайм-ауты сенсоров:
    • Не запускайте постоянный опрос сенсоров без указания лимита (-n 1). Неконтролируемый опрос датчиков приводит к быстрому разряду аккумулятора.
  3. Clipboard Sync:
    • Для передачи кода пользователю используйте termux-clipboard-set, чтобы текст сразу попадал в буфер обмена Android без ручного выделения.
  4. Wakelock Management:
    • Длительные фоновые расчеты должны удерживать termux-wake-lock и обязательно освобождать его (termux-wake-unlock) по завершении.

Ссылки и экосистема

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 318kUpdated Claude CodeCodexUnverifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 318kUpdated Claude CodeCodexUnverifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 318kUpdated Claude CodeCodexUnverifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 318kUpdated Claude CodeCodexUnverifiedInstall