Download
Zishu Terminal (Beta) on Stardust Store
https://stardustapkstore.zishuai.cloud/?appuid=-P2H9GGzLgqjw70iZ6pT
Zishu Terminal v5.6.5-beta.1
Zishu Terminal is a lightweight, Android-based developer environment. No root required. No native binaries. Just install and use the terminal.
This is v5.6.5-beta.1 — a beta release that adds one new feature and fixes several real bugs. Here's what changed.
---
🆕 New Feature — zgit clone
You can now clone public GitHub repositories directly inside the terminal:
```bash
zgit clone https://github.com/octocat/Hello-World
```
How it works:
· Downloads from GitHub's official codeload ZIP endpoint
· HTTPS with certificate verification
· Branch auto-detect — tries main, falls back to master
· Safe ZIP extraction — path traversal protection, size limits
· Extracts into a local folder and flattens the top-level directory
Example:
```bash
zgit clone https://github.com/github/gitignore
ls gitignore
# Actionscript.gitignore, Android.gitignore, Python.gitignore, ...
```
Is this git? No. It's a Java-based subset of git clone — for public repos and latest snapshots only. There is no git pull, git push, or commit history. We're honest about that.
---
🐛 Bug Fixes in v5.6.5-beta.1
1. Binary Output Rendering Fixed
Before: Running cat a.txt.zenc (an encrypted binary file) showed nothing. The output would suddenly appear only after the next command.
Why: The shell reader used BufferedReader.readLine(), which waits for a newline. Binary data has no newlines, so output got stuck in the buffer.
Now: Byte-level reading with a 100ms idle flush and an 8KB threshold — binary output renders immediately.
```bash
cat a.txt.zenc
# ZENCdZ...a.txt... (immediately)
```
2. zrun Is Now Shebang-Aware
Before: zrun script.sh always ran scripts through /system/bin/sh, even when the script started with #!/bin/bash. Bash-specific scripts failed with:
```
syntax error: unexpected operator/operand '=~'
```
Now: zrun reads the first line, detects the shebang, and finds the correct interpreter:
Shebang Interpreter Behavior
#!/bin/bash searches for bash Not found → clear error
#!/usr/bin/env python3 searches for python3 Not found → clear error
#!/system/bin/sh sh Runs
No shebang sh (default) Runs
No silent fallback. If bash isn't available, you get a clear error:
```bash
zrun test_bash.sh
# zrun: interpreter not available: bash
# (script shebang requires 'bash')
```
3. zrun Path Resolution Fixed
Before: zrun /absolute/path/script.sh → "Not found"
Now: All of these work:
```bash
zrun test1.sh # relative
zrun ./test1.sh # relative with ./
zrun /data/.../test1.sh # absolute
zrun ~/scripts/test.sh # home
zrun $HOME/scripts/test.sh # env var
```
4. zrun Verbose Mode
```bash
zrun -v test1.sh
# Interpreter: /system/bin/sh
# Script: /data/.../test1.sh
# Shebang: #!sh
```
Can also be enabled with the ZRUN_VERBOSE=1 environment variable.
5. zgit Documentation in zhelp
zhelp now includes zgit examples.
---
📋 Full Feature List
Shell & Sessions
· Real /system/bin/sh (non-interactive, no prompt leaks)
· Multiple sessions — create, rename, switch, close
· Command history — persistent, up/down navigation
· Autocomplete — commands, files, paths
· ANSI colors — 16 + 256 colors
· Real-time output — byte-level, binary-safe
Built-in Tools
· curl — real HTTPS with certificate verification, redirects, custom headers, POST data
· zprotect — AES-256-GCM encryption (PBKDF2, 100k iterations)
· zgit clone — GitHub repository downloader (snapshot only)
· zserver — local HTTP server with custom root and port
File Management
· File manager — browse, create, rename, delete, copy, move
· Text editor — open, edit, save, search, line numbers
· zfind — file search
· zrun — shell script execution (shebang-aware)
Userspace
· $PREFIX, $HOME, $TMPDIR — proper userspace layout
· Environment variables — proper expansion
· zenv — environment management
· zpath — print paths
Package Manager (Local)
· zpkg — 16 commands
· Local .zpkg package installation
· Repository management (add, list, enable, disable)
· Package database (installed tracking)
Projects & Jobs
· zproject — create, list, info, open, run, build, clean, delete
· zbuild — auto-detect project type
· zjobs — background job tracking
Customization
· Themes: Dark, Light, Green
· Profiles: font size, theme per profile
· Settings: font, padding, keep-awake, timestamps, confirm-clear
Diagnostics & Safety
· zdoctor — environment diagnostics
· ztools — detected tools
· zinfo — system information
· Backup / restore — settings and history
· zdiagnostics — diagnostics screen
UI
· 19-item menu (side popup, scrollable)
· Terminal keyboard bar (Tab, Up, Down)
· Session labels
· Custom prompt with path shortening
---
⚠️ Beta Notice — Honest Disclosure
This is a beta build. Some things are incomplete:
zpkg Remote Support — Disabled
Remote package downloads are disabled in this build. They are planned for a future release.
What works now:
· Local .zpkg directory installation
· Repository management (config only)
· Package database tracking
What doesn't work yet:
· Downloading from remote repositories
· Remote search/info
This feature is planned for v6.0.0 with shell-script packages.
Native Binaries — Not Supported
· Python, Git, Node.js, GCC, Clang — these are native binaries
· Android 10+ W^X restriction prevents executing native binaries from app-private directories
· Termux solves this by bundling binaries in the APK's lib/ folder
· That requires NDK + Gradle, which isn't available in our current environment
· We don't fake features. These things aren't here, and we say so clearly
zgit Limitations
· Public repositories only
· Latest snapshot only — no git history
· No git pull, git push, or git commit
· Equivalent to git clone only
This Is Not Termux
We don't claim this is a Termux replacement. Termux provides a real Linux toolchain (Python, Git, Node, compilers). Zishu Terminal provides Java-based tools that run inside Android.
---
🛠️ Technical Details
Property Value
Package com.zishu.terminal
Version Name 5.6.5-beta.1
Version Code 565
Min SDK 21 (Android 5.0)
Target SDK 29 (Android 10)
Language Java (traditional Java 6/7 syntax)
UI Classic Android (android.app.Activity)
Dependencies None (no Gradle libraries)
Java Files 51+
Architecture:
· Real Process for shell (/system/bin/sh)
· SessionManager for multiple shells
· Custom AnsiParser for colored output
· CurlBridge — Java HTTPS client
· ZishuProtect — AES-GCM encryption
· ZgitClone — GitHub codeload ZIP client
· ShebangParser + InterpreterResolver — zrun support
· ZpkgManager — local package system
No: Kotlin, AndroidX, Material Components, Gradle dependencies, NDK.
---
🚀 Roadmap
· v6.0.0 — zpkg remote support (shell-script packages from a GitHub repository)
· Improvements in existing tools
· More themes and customization
· Bug fixes based on user feedback
Native binaries — we will stay honest. They are not possible in our current environment. If NDK + Gradle become available in the future, then maybe.
---
📥 Download
Zishu Terminal v5.6.5-beta.1 — available on Stardust Store
https://stardustapkstore.zishuai.cloud/?appuid=-P2H9GGzLgqjw70iZ6pT
---
🙏 Final Word
This terminal is honest. Features that exist work. Features that don't exist are clearly stated.
· No fake "AI-powered" claims
· No fake "hacking tools"
· No fake "root access"
· No fake "Termux replacement"
Just real features and honest limitations.
If you find a bug or want a feature, feedback is welcome.
Zishu Terminal — a small, honest, developer-friendly terminal.