[{"_1":2,"_176":-5,"_177":-5},"loaderData",{"_3":4,"_17":18,"_24":25,"_152":153},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":11,"_23":21},"username","isAskGordonEnabled",true,"showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_26":27,"_28":-5,"_29":11,"_30":11,"_31":32,"_33":34,"_35":-5,"_36":11,"_37":38,"_97":-5,"_98":99,"_139":-5,"_140":11,"_141":21,"_142":11,"_143":11,"_144":11,"_145":-5,"_146":11,"_147":-5,"_148":149,"_150":100,"_151":-7},"canonicalUrl","https://hub.docker.com/r/credkellar/ios2termux/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","credkellar","reponame","ios2termux","cloudBuildSource","isAutobuildsAvailable","repo",{"_39":40,"_52":53,"_55":56,"_57":58,"_59":11,"_60":61,"_62":63,"_64":65,"_42":34,"_31":32,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":-5,"_76":77,"_78":79,"_80":11,"_81":32,"_82":83,"_88":11,"_89":90,"_94":32,"_95":96},"categories",[41,46,49],{"_42":43,"_44":45},"name","Machine learning & AI","slug","machine-learning-and-ai",{"_42":47,"_44":48},"Developer tools","developer-tools",{"_42":50,"_44":51},"Operating systems","operating-systems","content_types",[54],"image","date_registered","2026-11-07T18:10:37.863262Z","description","iOS to real Termux, honestly: SSH from iPhone, translate commands & paths, Carbon 4 decides safely.","is_private","last_updated","2026-11-07T18:17:26.960114Z","last_modified","2026-11-07T18:21:01.364625Z","media_types",[66],"application/vnd.oci.image.index.v1+json","pull_count",72,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","# iOS2Termux 📱➡️🐚\n\n**iOS to Termux with Gemini Carbon 4 Extended Thinking** 🧠✨\n\nCreated by Darion Kellar · [GitHub: credkellar/iOS-Termux](https://github.com/credkellar/iOS-Termux)\n\n![Python](https://img.shields.io/badge/Python-3.12-3776AB?logo=python&logoColor=white)\n![Gemini Carbon 4](https://img.shields.io/badge/Gemini-Carbon%204%20Extended%20Thinking-8E75B2?logo=google&logoColor=white)\n![Termux](https://img.shields.io/badge/Termux-Android%20only-black?logo=termux&logoColor=white)\n![iOS](https://img.shields.io/badge/iOS-cockpit-000000?logo=apple&logoColor=white)\n![Tests](https://img.shields.io/badge/tests-43%20passed-brightgreen)\n![Checks](https://img.shields.io/badge/checks-48%2F48-brightgreen)\n![Dependencies](https://img.shields.io/badge/dependencies-0-blue)\n![Routes](https://img.shields.io/badge/routes-8%20classified-blueviolet)\n![Translations](https://img.shields.io/badge/translations-16%20pairs-orange)\n![HOLD Gates](https://img.shields.io/badge/HOLD%20gates-8%20armed-red)\n![License](https://img.shields.io/badge/license-MIT-green)\n![CI](https://img.shields.io/github/actions/workflow/status/credkellar/iOS-Termux/ci.yml?branch=main&label=CI)\n![Docker Publish](https://img.shields.io/github/actions/workflow/status/credkellar/iOS-Termux/docker-publish.yml?branch=main&label=Docker%20Publish)\n\n\n> 🚫 **Termux is Android-only. There is NO Termux for iOS.** You cannot install a Termux APK / .deb on an iPhone, and no jailbreak is offered or required.\n> 🐚 **iOS shells are NOT Termux:** iSH (Alpine, `apk`), a-Shell and Blink Shell are cockpits/clients, not Termux.\n> ✅ **What works:** SSH from the iPhone into a **real Termux** on an Android device (port 8022), a **Termux-style cloud box**, **command translation** for iOS shells, and **shared-storage file transfer** via `~/storage/downloads`.\n\n---\n\n## 📖 What is this about?\n\nThis project started with a simple question: **\"How do I use Termux when my phone is an iPhone?\"** 📱\n\nThe honest answer has four parts:\n\n1. 🚫 **Native Termux on iOS does not exist.** Termux is built for Android — its packages, its `$PREFIX` paths, its `.deb` files. An iPhone cannot install an APK, and there is no iOS build. Every \"Termux for iPhone\" claim is fake.\n2. 🐚 **iOS shells are real, but they are not Termux.** iSH runs Alpine Linux in user mode (`apk`, not `pkg`). a-Shell and Blink Shell are useful cockpits/clients. None of them becomes Termux, and none can host `sshd`.\n3. ✅ **The winning route is SSH.** Put real Termux on an Android device, start `sshd` (port 8022), and ssh in from iSH / Blink / Termius on the iPhone — same LAN, or Tailscale across networks. The iPhone is the cockpit; the Android device runs the real Termux.\n4. ☁️ **No Android handy?** A cloud Linux box (Codespaces from the phone browser) with a `pkg`-style wrapper feels Termux-like, Termux commands **translate** to iSH equivalents for local work, and files move through iOS Files into Termux `~/storage/downloads`.\n\n**iOS2Termux turns that answer into a tool**: it classifies every route honestly, translates commands and paths both ways, plans the exact SSH / cloud / transfer setup phone-first, and HOLDs 🛑 the impossible or dangerous requests — decided by **Gemini Carbon 4 Extended Thinking**, gated by hard HOLD rules it can never override.\n\n---\n\n## 🎯 What this does?\n\n- 🗂️ **Classifies 8 routes** — impossible / shell-only / ssh-client / real-Termux / cloud / transfer-only — with an honest verdict for each\n- 🔀 **Translates 16 command pairs both ways** — Termux <-> iOS (iSH): `pkg install` <-> `apk add`, clipboard, TTS, open, and more\n- 🛣️ **Translates paths both ways** — `~/storage/downloads` <-> iOS Files `On My iPhone/Downloads`, Termux `$HOME`/`$PREFIX` <-> iSH paths, and the `~/downloads` private-folder warning ⚠️\n- 🛡️ **Rejects hostile shell input** — `; rm -rf`, `$(...)`, backticks and pipes into `sh` are refused before they can become a command\n- 🗺️ **Plans any route** — phone-first taps, the exact commands for each side, and generated files\n- 📄 **Generates `setup-termux.sh`** — the one-time Android-side setup (openssh, storage, `sshd`, `whoami`, `ip addr`)\n- 📄 **Generates an ssh config snippet + a translate cheat-sheet (.md)**\n- 🧠 **Decides with Gemini Carbon 4 Extended Thinking** — MAP -> MODEL -> STRESS -> DECIDE, extended tier (32768 budget) by default\n- 🛑 **Enforces 8 HOLD gates** — impossible claims, public `sshd` with no auth, secrets in command history, `rm -rf` on shared storage, unextracted archives, the private-downloads trap\n- 🔗 **Keeps a hash-chained blackbox log** of plans and verdicts, tamper-evident\n- 🤖 **Registers freeai advisor seats by name only** — including the Muse seat (`MODEL_API_KEY`, Meta, pay-as-you-go) — advisors can recommend, they can **never** override a HOLD\n\n---\n\n## 🔧 How this works?\n\n### The truth table 📋\n\n| Route | Real Termux? | Reality |\n|---|---|---|\n| Termux on iOS (`termux_on_ios`) | ❌ | **Impossible** — Android-only, no iOS build exists. HOLD. |\n| APK / .deb on iOS (`apk_on_ios`) | ❌ | **Impossible** — iOS cannot install Android packages. HOLD. |\n| iSH (`ish_shell`) | ❌ shell only | Alpine shell on iOS: real shell + Python, Termux commands translate (`pkg` -> `apk`). |\n| a-Shell (`a_shell`) | ❌ shell only | Native iOS shell, its own command set. A cockpit, not Termux. |\n| Blink Shell (`blink_ssh`) | ❌ client only | A polished ssh/mosh **client** — connects to Termux, is not Termux. |\n| **SSH to Android Termux** ⭐ (`ssh_to_android_termux`) | ✅ | **Recommended.** Real Termux + `sshd` on Android, iPhone ssh-es in (port 8022). |\n| Cloud-Termux (`cloud_termux`) | ☁️ Termux-style | Cloud Linux (e.g. Codespaces) + `pkg`-like wrapper, driven from the phone browser. |\n| Files transfer (`ios_files_transfer`) | 📁 transfer only | iOS Files -> shared Download folder -> Termux `~/storage/downloads`. |\n\n### The flow 🌊\n\n1. 📱 You pick a route (default: SSH into real Termux)\n2. 🧠 Carbon 4 runs MAP -> MODEL -> STRESS -> DECIDE; the HOLD gates run inside STRESS\n3. 🛑 Any gate tripped = **HOLD**, printed with its reason — Carbon 4 can never loosen it\n4. 🗺️ Clear plans emit phone steps + exact commands + generated files\n5. 🔗 The blackbox logs the plan and the verdict\n\n### 🛑 The HOLD gates\n\n| Gate | Trigger |\n|---|---|\n| `native_termux_claim` | Claiming Termux runs natively on iOS |\n| `apk_install_on_ios` | Installing a Termux APK / .deb on an iPhone |\n| `jailbreak_required` | A plan that requires a jailbreak (none is offered, none is needed) |\n| `sshd_public_no_auth` | Exposing `sshd` to the public internet with no auth / password-only |\n| `secrets_in_command_history` | An API key pasted as a plain command argument (lands in shell history) |\n| `rm_rf_storage` | `rm -rf` against `~/storage` or `/` — wipes shared phone storage |\n| `unextracted_archive_run` | Trying to run Python from inside a `.zip` without extracting it first |\n| `private_downloads_confusion` | Expecting shared files in `~/downloads` — that is Termux's **private** folder; shared files belong in `~/storage/downloads` |\n\n### 🧠 Gemini Carbon 4 Extended Thinking\n\n- **Engine:** `gemini-2.5-pro` · **Model ID:** `google/gemini-carbon-4-extended-pro-thinking`\n- **Thinking tiers:** standard 2048 · deep 8192 · **extended 32768 (default)**\n- **Phases:** MAP (name the action + route) -> MODEL (require the facts) -> STRESS (worst cases + the HOLD gates) -> DECIDE (strictest verdict: HOLD / PROCEED)\n- **Offline structure is authoritative.** A live polish (only when `GEMINI_API_KEY` is present — detected by name only, value never read) can only **tighten** a verdict, never loosen one.\n- **Negative controls, locked in by tests:** a plain `pkg install python` translation must NOT escalate to HOLD ✅ · a local iSH `ls` / `python3 script.py` must NOT be held just because Termux is absent ✅ · a single benign transfer to `~/storage/downloads` must PROCEED ✅\n\n### 🏗️ Architecture\n\n```mermaid\nflowchart TD\n A[\"📱 iPhone
iSH / Blink / Safari\"] --> B[\"main.py
ONE interface\"]\n B --> C[\"🗺️ planner.py
route → plan\"]\n C --> D[\"🧠 carbon4.py + brains.py
Carbon 4 decides · gates HOLD\"]\n D -->|HOLD 🛑| E[\"exit 2
reason printed\"]\n D -->|clear ✅| F[\"📋 phone steps + commands + files\"]\n C --> G[\"🗂️ routes.py
8 routes, honestly classified\"]\n C --> H[\"🔀 translate.py
16 pairs + paths, injection-proof\"]\n F --> I[\"🐧 REAL Termux on Android
sshd :8022\"]\n F --> J[\"☁️ Cloud-Termux
Codespaces + pkg wrapper\"]\n B --> K[\"🔗 blackbox.py
hash-chained log\"]\n B --> L[\"🤖 freeai.py
advisor seats, names only\"]\n```\n\n---\n\n## 😎 Why is this cool?\n\nBecause it tells the truth and then makes the truth useful. Most \"Termux on iPhone\" content is either a lie or a dead end. This project draws the exact line between impossible, shell-only, and actually-works — then automates the part that works, end to end, from a phone, with an extended-thinking decider that is forbidden from overriding its own safety gates. 📱✨\n\n## 🔟 10 reasons why this is cool\n\n1. 🧭 **Honesty as a feature** — the impossible routes are labelled impossible, in code, with gates that enforce it\n2. ⭐ **One recommended route** — SSH into real Termux: every `pkg`, path and tool, from your iPhone\n3. 🔀 **A real translator** — 16 command pairs + path translation, both directions, not a blog-post table\n4. ⚠️ **The downloads trap is encoded** — `~/downloads` (private) vs `~/storage/downloads` (shared) is a gate, a warning, and a test\n5. 🧠 **Extended thinking, on a leash** — Carbon 4 decides with a 32768 budget, and a HOLD still always wins\n6. ✅ **Negative controls** — tests prove benign work (translations, local iSH, one file transfer) is NOT over-held\n7. 📄 **Files that generate themselves** — `setup-termux.sh`, the ssh config, and the cheat-sheet come out of the planner\n8. 🛡️ **Injection-proof by design** — a hostile command can never smuggle shell syntax into a plan\n9. 0️⃣ **Zero dependencies** — pure Python 3.12 stdlib; runs anywhere Python runs, including inside its own Docker image\n10. 🔗 **Tamper-evident memory** — plans and verdicts are hash-chained in the blackbox\n\n---\n\n## 🐳 Run it\n\n```bash\ndocker pull credkellar/ios2termux:latest\ndocker run --rm credkellar/ios2termux\n# 🧪 expect: CHECKS 48/48 PASS · VERDICT: PROCEED\n```\n\nFrom source:\n\n```bash\ngit clone https://github.com/credkellar/iOS-Termux.git\ncd iOS-Termux\npython3 main.py # self-check\npython3 main.py --plan # the recommended SSH plan\npython3 main.py --translate \"pkg install python\" --to ios\n```\n\n---\n\n## 📋 The numbers\n\n- 🧪 **43 tests passed** · **CHECKS 48/48** · 0️⃣ **zero dependencies** (pure Python 3.12 stdlib)\n- 🛂 **8 routes** classified · 🔀 **16 command translations** + 5 path translations, both directions\n- 🛑 **8 HOLD gates** · 🧠 **Gemini Carbon 4 Extended Thinking** decides (32768 extended budget) and can never override a HOLD\n- 📱 Phone = cockpit · 🤖 Android Termux = engine · 🔐 SSH port 8022 = the bridge\n","has_starred","hub_user","immutable_tags_settings",{"_84":11,"_85":86},"enabled","rules",[87],".*","is_automated","permissions",{"_91":21,"_92":11,"_93":11},"read","write","admin","user","storage_size",43371850,"orgData","recentTags",[100],{"_101":54,"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_60":128,"_129":103,"_130":32,"_131":66,"_42":132,"_133":134,"_135":119,"_136":128,"_137":74,"_138":21},"content_type","creator",42360781,"digest","sha256:e463baa48060dec7a6cf7edddcb227764a2b1a99cb918b4846269e7482c18c9b","full_size",43296419,"id",1391160378,"images",[112],{"_113":114,"_104":115,"_116":117,"_118":119,"_120":121,"_122":123,"_124":117,"_125":-5,"_126":107,"_72":74,"_127":-5},"architecture","amd64","sha256:e8945e5eda3862dc2bd5a6ed18f76f526d9d5afcdbaa0058c23030bcc3cf0b8a","features","","last_pulled","2026-11-10T23:31:37.325140393Z","last_pushed","2026-11-07T18:17:25.563969195Z","os","linux","os_features","os_version","size","variant","2026-11-07T18:17:26.494781Z","last_updater","last_updater_username","media_type","latest","repository",33242279,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxAgenticPlatformBadge","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_37":154,"_164":165,"_148":174,"_175":11},{"_39":155,"_52":159,"_55":56,"_57":58,"_59":11,"_60":61,"_62":63,"_64":160,"_42":34,"_31":32,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":-5,"_76":77,"_78":79,"_80":11,"_81":32,"_82":161,"_88":11,"_89":163,"_94":32,"_95":96},[156,157,158],{"_42":43,"_44":45},{"_42":47,"_44":48},{"_42":50,"_44":51},[54],[66],{"_84":11,"_85":162},[87],{"_91":21,"_92":11,"_93":11},"tags",{"_166":71,"_167":-5,"_168":-5,"_169":170},"count","next","previous","results",[171],{"_101":54,"_102":103,"_104":105,"_106":107,"_108":109,"_110":172,"_60":128,"_129":103,"_130":32,"_131":66,"_42":132,"_133":134,"_135":119,"_136":128,"_137":74,"_138":21},[173],{"_113":114,"_104":115,"_116":117,"_118":119,"_120":121,"_122":123,"_124":117,"_125":-5,"_126":107,"_72":74,"_127":-5},[],"canDeleteTags","actionData","errors"]

credkellar/ios2termux

Tags for credkellar/ios2termux