Skip to content

AnCLI v1.0.0 — Unified CLI Environment Manager

Choose a tag to compare

@AHLLX AHLLX released this 02 Jul 05:22
· 70 commits to main since this release

AnCLI v1.0.0 — Unified CLI Environment Manager for Android

Welcome to the initial official release of AnCLI (Android CLI)! 🚀

AnCLI is a systemless plugin-based environment manager designed to bring full-featured Linux command-line tools (such as Python, Node.js-based AI agents, Go binaries) to rooted Android devices (KernelSU, APatch, Magisk). It solves Bionic C library incompatibilities by using PRoot to execute an Ubuntu glibc base container system transparently.


Key Features in v1.0.0

1. Systemless "Dual-Injection" Hack

  • Since Android's /system/bin is strictly read-only, AnCLI implements systemless module injection.
  • Exposes installed tools (like aider, claude) to the host path instantly via Path A (/data/adb/modules/ancli/system/bin/) for reboot persistence, and Path B (/data/adb/ksu/bin/ or /data/adb/ap/bin/) for instant execution without rebooting.

2. Native Python Installer Bypass

  • Solves Windows-to-Android console escaping and shell pipeline characters (|, --) being stripped or corrupted during ADB command forwarding.
  • Native Python urllib downloader handles installation script fetches inside the guest container.

3. NPM-Free Standalone Binaries

  • Major AI coding agents (such as Claude Code, OpenCode, and MiMo Code) have been decoupled from heavy npm / nodejs installations.
  • Downloads are routed to precompiled standalone ELF binaries, saving hundreds of megabytes of disk space and eliminating node-gyp compile issues.

4. Automatic HTTP Proxy Redirection & Fallback

  • Dynamically forwards HTTP/HTTPS proxies from host (e.g., PC-based ladders or local VPNs) into the PRoot guest container.
  • If a custom HTTP proxy is configured or detected, it redirects container installer requests automatically.

5. Safety Commands Whitelist

  • For security against untrusted registry injections, execution is restricted to safe command prefixes (pip, npm, apt-get, apt, curl, rm, agy, bash, sh).

Installation & Quick Start

  1. Install the flashable ancli-module.zip via Magisk / KernelSU / APatch manager.
  2. Open Termux or any terminal as root, and use the包管理器:
    • List available apps: ancli list
    • Install an app (e.g., Claude Code): ancli install claude-code
    • Uninstall an app: ancli uninstall claude-code
    • Configure environment variables: ancli config claude-code