Android/Termux constraints reference. An agent skill from ferrumclaudepilgrim/claude-code-android.

MITAuto-check passedDevOps & Cloud

Install Termux Safe

skills CLI
$ npx skills add ferrumclaudepilgrim/claude-code-android --skill termux-safe -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ferrumclaudepilgrim/claude-code-android termux-safe --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ferrumclaudepilgrim/claude-code-android.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/termux-safe .claude/skills/termux-safe && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
termux-safe
GitHub stars
268
Token cost
~935 tokens
SKILL.md length
477 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Android/Termux constraints reference. An agent skill from ferrumclaudepilgrim/claude-code-android.

  • Tasks that involve Linux administration
  • SKILL.md covers Hard Rules: Never Suggest These, Silent Failure Modes, Package Installation and When Unsure
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Termux Safe is an agent skill from ferrumclaudepilgrim/claude-code-android. Android/Termux constraints reference. Prevents Claude Code from suggesting commands that fail silently on Android (sudo, systemd, non-Termux paths, etc.).

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Linux administration. It works with Android, Linux and Node.js. The repository describes itself as: Run Claude Code natively on Android via Termux or AVF (Android Virtualization Framework) -- no desktop, no SSH, no root required. The licence is MIT.

When your agent uses it

  • Tasks that involve Linux administration

Example prompts

  • “/termux-safe”

Requirements

  • Node.js
  • Docker

What it can do on your machine

Read from SKILL.md and the folder at commit cf30402. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Termux Safe loads about 935 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 477 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~935

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ferrumclaudepilgrim/claude-code-android at commit cf30402, republished under its MIT licence (© ferrumclaudepilgrim). 477 words, ~935 tokens.

Download SKILL.mdSave it as .claude/skills/termux-safe/SKILL.md (or your agent's skills folder).
name
termux-safe
description
Android/Termux constraints reference. Prevents Claude Code from suggesting commands that fail silently on Android (sudo, systemd, non-Termux paths, etc.).
user-invocable
false
disable-model-invocation
false

Android / Termux Environment Constraints

Scope and when this applies. These constraints apply when you are executing inside Termux on Android, regardless of how Claude Code itself was packaged. The load-bearing runtime signal is $PREFIX === "/data/data/com.termux/files/usr". If that environment variable points at Termux's prefix, you are in Termux and these constraints apply, even if process.platform reports "linux" (it will report "linux" if Claude Code was installed via this repo's v2.9.0 Path A, which runs the linux-arm64 binary patched via glibc-runner; it will report "android" only on older Path A v2.x installs that used the JS bundle). If $PREFIX is unset or points at /usr, you are inside a chroot-like sandbox (for example, a Linux rootfs running under proot-distro, Path B) or inside a hypervisor-managed Linux VM (Path C), and standard Linux conventions apply; most of this file does not.

If the runtime signals indicate the in-Termux case, the constraints below produce silent failures, not errors. Every suggestion must account for them.

Hard Rules: Never Suggest These

  • No sudo. Root does not exist. No su, no doas, no privilege escalation of any kind.
  • No systemctl or systemd. Android does not use systemd. No journalctl, no service, no unit files.
  • No standard Linux paths. /usr/bin, /etc, /var do not exist or are not writable. Termux paths:
    • Home: /data/data/com.termux/files/home
    • Prefix: /data/data/com.termux/files/usr
    • Binaries: $PREFIX/bin
    • Config: $PREFIX/etc
  • No ports below 1024. No root = no binding to 80, 443, etc. Use 1024+.
  • Prefer pkg over apt. Both work, but pkg auto-updates the package index before installing.
  • No Docker, no containers. The kernel does not support them without root.
Show full SKILL.md (216 more words)Show less

Silent Failure Modes

  • Node.js is not required by this repo's install.sh. The patched linux-arm64 claude binary is self-contained. If Node is installed separately on native Termux, prefer v25+: v24 had a documented startup hang on ARM64 that was resolved in v25.
  • File descriptor limits vary by device. Check with ulimit -n. Avoid spawning many concurrent processes.
  • Android phantom process killer limits background processes to ~32 across all apps. If "Disable child process restrictions" is enabled in Developer Options, this limit is lifted; 6 concurrent subagents have been observed stable in testing. Otherwise limit to 2-3.
  • process.platform reporting varies by install path. On Path A v2.9.0 (the linux-arm64 binary patched via glibc-runner), Node.js reports process.platform === "linux" even though you are inside Termux. On older Path A v2.x (the JS-bundle npm install) it reports "android". On Path B (proot-distro Ubuntu) and Path C (AVF), it reports "linux" and you are not in Termux. The reliable cross-path signal that you are still in Termux is $PREFIX === "/data/data/com.termux/files/usr".

Package Installation

Prefer pkg (auto-updates the index before install). apt and apt-get also work but skip the auto-update:

bash
pkg install <package> -y
pkg upgrade
pkg search <query>

When Unsure

If you're about to suggest a command that assumes standard Linux, stop and verify it works on Termux first. When in doubt, prefix with command -v <tool> >/dev/null 2>&1 to check availability.

© ferrumclaudepilgrim, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/termux-safe of ferrumclaudepilgrim/claude-code-android.

Open the folder on GitHubat commit cf30402

Compare with similar skills

Termux Safe next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Termux Safe compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Termux Safe this skillferrumclaudepilgrim/claude-code-android268—~935Automated safety check: PassMIT
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Openbkn Deployopenbkn-ai/bkn-foundry645—~1.9kAutomated safety check: NotesCustom licence
Minimegasandia-minimega/minimega160—~3.2kAutomated safety check: PassGPL-3.0-only
Setup Cpu Proxy Serverdrawthingsai/draw-things-community582—~3.8kAutomated safety check: PassGPL-3.0
Shadowvpn Deploy Servermadeye/shadowvpn101—~1.5kAutomated safety check: NotesMIT

Similar skills

  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Openbkn Deploy

    openbkn-ai/bkn-foundry

    Deploy or upgrade OpenBKN on a customer-authorized Linux server through the repository's deploy scripts, with preflight checks, explicit confirmation, secret handling, and post-deployment…

    645 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Minimega

    sandia-minimega/minimega

    This skill should be used when the user asks how to configure, run, automate, integrate, or troubleshoot minimega (VMs, namespaces, VLANs, clusters, miniccc, miniweb, command socket or Python API…

    160 GitHub stars~3.2k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Setup Cpu Proxy Server

    drawthingsai/draw-things-community

    Set up and verify a new Draw Things CPU proxy and Envoy server using the scripts in Scripts/ServerManagement/CPUScript.

    582 GitHub stars~3.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Shadowvpn Deploy Server

    madeye/shadowvpn

    Deploy, install, and run the ShadowVPN server in a target environment (Linux/systemd).

    101 GitHub stars~1.5k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Alibabacloud Ecs Linux Os Troubleshooting

    aliyun/alibabacloud-ecs-troubleshoot-skills

    Troubleshoot an Alibaba Cloud ECS Linux OS. An agent skill from aliyun/alibabacloud-ecs-troubleshoot-skills.

    148 GitHub stars~4.1k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from ferrumclaudepilgrim/claude-code-android

  • Minimum Viable

    ferrumclaudepilgrim/claude-code-android

    Before building anything, justify the tool choice and complexity level.

    268 GitHub stars~538 tokensUpdated 2 mo ago
    Auto-check: notes
  • Scope Framing

    ferrumclaudepilgrim/claude-code-android

    Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope.

    268 GitHub stars~552 tokensUpdated 2 mo ago
    Auto-check: notes

Questions about Termux Safe

What does Termux Safe do?

Android/Termux constraints reference. An agent skill from ferrumclaudepilgrim/claude-code-android. Termux Safe is an agent skill from ferrumclaudepilgrim/claude-code-android. Android/Termux constraints reference.

When should I use Termux Safe?

Termux Safe fits situations like: tasks that involve Linux administration.

How do I install Termux Safe in Claude Code?

Run `npx skills add ferrumclaudepilgrim/claude-code-android --skill termux-safe -a claude-code`. Or copy the skill folder (.claude/skills/termux-safe in ferrumclaudepilgrim/claude-code-android) into .claude/skills/termux-safe in your project. Claude Code loads it when a task matches its description.

How do I install Termux Safe in Codex?

Run `npx skills add ferrumclaudepilgrim/claude-code-android --skill termux-safe -a codex`. Or copy the skill folder (.claude/skills/termux-safe in ferrumclaudepilgrim/claude-code-android) into .agents/skills/termux-safe in your project. Codex loads it when a task matches its description.

Can I use Termux Safe in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ferrumclaudepilgrim/claude-code-android --skill termux-safe -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/termux-safe, .gemini/skills/termux-safe, .github/skills/termux-safe and .opencode/skills/termux-safe in your project.

What does Termux Safe need to run?

SKILL.md names no scripts, command-line tools or credentials: Termux Safe is instructions for the agent only. Our summary lists: Node.js; Docker.

Does Termux Safe access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Termux Safe safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Termux Safe use?

Termux Safe is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Termux Safe use?

About 935 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Termux Safe?

Skills that share tags, products or a category with Termux Safe: Openclaw Live Updater (openclaw/openclaw, 392k stars), Openbkn Deploy (openbkn-ai/bkn-foundry, 645 stars), Minimega (sandia-minimega/minimega, 160 stars) and Setup Cpu Proxy Server (drawthingsai/draw-things-community, 582 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Termux Safe?

ferrumclaudepilgrim (a GitHub user) maintains it in ferrumclaudepilgrim/claude-code-android, which has 268 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on July 27, 2026.

Source: ferrumclaudepilgrim/claude-code-android on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.