ATLAS-OS User Manual & Terminal Command Reference
Everything you need to install ATLAS-OS Titan Edition, use its eight core tools, fix the common snags, and run its Linux terminal like a daily driver.
Part I
1. System requirements
2. Installation guide
Step 1 — Download the APK
Open your phone's browser and go to the official releases page, then tap ATLAS-OS.apk to download it.
Step 2 — Install and allow the security prompt
- If you see "Install from Unknown Sources" or "Chrome needs permission," open Settings and enable Allow.
- Tap Install.
- Once installed, find the gold ATLAS-OS logo on your home screen or app drawer.
3. App interface overview
Opening the app shows three main areas:
4. Feature walkthrough
Tap a tool to expand its steps.
4.1 — Local web server
Turn your phone into a real HTTP file and web server.
- Open the Local Web Server card on the dashboard.
- Tap Start Web Server.
- A notification appears:
Server running at http://<phone-ip>:8080. - Put your phone and laptop on the same Wi-Fi or hotspot, then open
http://<phone-ip>:8080(e.g.http://192.168.0.105:8080) in any laptop browser — the phone's file directory opens with no cable needed. - When finished, return to the app and tap Stop Web Server.
4.2 — Terminal hacker keybar
Open the Terminal tab. A dedicated black-and-gold key row appears above the keyboard the moment it opens:
TAB— autocompletes a partially typed command or filename.ESC— exitsnanoorvi.CTRL— combine withCto stop a running process, orLto clear the screen.|— inserts a pipe without switching to symbols mode, e.g.ls | grep py.~&&&— jump to the home directory or chain commands on one line.
4.3 — Live hardware pulse monitoring
The pulse meter at the top of the screen refreshes automatically every 2 seconds at negligible battery cost — watch RAM climb during a heavy build, or check whether battery temperature is rising under load, live.
4.4 — Network ping tester
Find your Wi-Fi or mobile data's real latency.
- Tap Network Diagnostics on the dashboard.
- The app sends a low-level socket ping directly to Google's DNS server
8.8.8.8. - Within 3 seconds, your real latency appears in milliseconds — e.g.
24 ms — Ultra Low Latency / Excellent Connection.
4.5 — Dark / light theme switching
Tap the moon icon in the top bar for a true AMOLED obsidian-black background — easier on the eyes and the battery at night. Tap the sun icon for a high-contrast Paper Light White theme for daylight readability.
4.6 — Linux task manager (process killing)
See what's running in the background and stop anything stuck.
- Open the Task Manager section.
- It lists running Linux processes with their process ID (PID) and memory usage.
- Tap Kill next to any process to send a termination signal.
4.7 — Display refresh rate & sensor telemetry
Tap Sensors & Display to read your actual refresh rate (60/90/120 Hz) straight from the display controller, along with screen DPI scaling and live 3-axis gyroscope and accelerometer movement.
4.8 — Code scaffolding & one-tap ZIP export
Start a new project instantly and back it up just as fast.
- Choose from the Code Templates dropdown: Python CLI Script, Node.js Express Server, or C++ Clang Template.
- Tap Generate to create the file with complete, standard syntax.
- Tap Export Project ZIP to save the whole project as a compressed
.zipto your downloads folder.
5. Pro tips & workflow
Wireless lab workflow
No cable needed. Keep ATLAS-OS's local web server running on your phone and push code or pull files directly from your laptop over Wi-Fi.
Keep it running in the background
Set ATLAS-OS's Battery Optimization to Unrestricted or Not optimized in your phone's settings, so the web server and processes keep running even with the screen off.
6. Troubleshooting & FAQ
Why won't http://<phone-ip>:8080 open in my laptop's browser?
Make sure your laptop and phone are on the same Wi-Fi network. If Wi-Fi isn't available, turn on your phone's mobile hotspot, connect your laptop to it, and use the IP address shown on the phone.
A terminal command got stuck in a loop — what do I do?
Tap CTRL on the hacker keybar, then press C — this sends Ctrl+C and immediately interrupts the running process.
Can someone else rename or claim my code or the app?
No. The source code is protected under the GNU GPL v3.0 license. Anyone reusing it must credit the original creator, Nafiul Ahmad Rafi, and Atlas AI Institute.
7. Legal notice
========================================================================
OFFICIAL COPYRIGHT & IP NOTICE
========================================================================
ATLAS-OS (Titan Edition) — Version 2.0
Conceived, Architected & Authored by Nafiul Ahmad Rafi.
Affiliation: Director, Atlas AI Institute.
AI Policy and Governance Researcher | Civic Tech Architect.
Copyright (c) 2026 Nafiul Ahmad Rafi. All Rights Reserved.
Licensed under the GNU General Public License v3.0 (GPL-3.0).
Institutional Email: rafi@atlasai.institute
LinkedIn: https://bd.linkedin.com/in/nafiul-ahmad-rafi
GitHub: https://github.com/rafinafiulahmad/Atlas-OS---A-Linux-Operating-System-for-Mobile-
========================================================================Part II
Terminal command reference
Every supported command, flag, and syntax pattern inside the ATLAS-OS mobile terminal environment.
System & hardware telemetry
| Command | Syntax | Description |
|---|---|---|
uname | uname -a | Kernel release, architecture, and machine info. |
free | free -m | Total, used, and free RAM in megabytes. |
df | df -h | Internal storage usage, human-readable. |
uptime | uptime | Time since the device last booted. |
whoami | whoami | Current active user in the terminal sandbox. |
id | id | User ID, group ID, and permissions. |
env | env | Active environment variables (PATH, HOME, SHELL). |
File & directory management
ls — list directory contents
ls -l— long format: permissions, size, owner, date.ls -a— include hidden dotfiles.ls -lh— long format with human-readable sizes.
ls -lahpwd — print working directory
pwd
# Output: /data/user/0/com.atlas.mobile.agent/files/homecd — change directory
cd ..— go up one level.cd ~— go to your home workspace.cd /sdcard— access external storage.
mkdir — create a directory
mkdir -p my_project/src
# Creates 'my_project' and the nested 'src' foldertouch & cat — create and view files
- Create an empty file:
touch script.py - View a file's contents:
cat script.py - Concatenate files:
cat header.txt body.txt > full.txt
cp & mv — copy, move, rename
- Copy a file:
cp source.txt backup.txt - Copy a folder recursively:
cp -r project/ backup_project/ - Move or rename:
mv old_name.py new_name.py
rm — remove files & folders
- Delete a file:
rm file.txt - Delete a folder:
rm -rf old_project/— deleted files can't be restored.
Network & connectivity diagnostics
ping — raw socket latency test
Sends ICMP echo requests to measure latency and packet loss.
ping -c 4 8.8.8.8
64 bytes from 8.8.8.8: icmp_seq=1 ttl=116 time=26.4 ms
64 bytes from 8.8.8.8: icmp_seq=2 ttl=116 time=24.1 ms
--- 8.8.8.8 ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, avg = 25.2 mscurl — web client & API requests
- Inspect HTTP headers:
curl -I https://google.com - Download a remote file:
curl -O https://example.com/data.json - Test the local server:
curl http://localhost:8080/
ip addr / ifconfig — network adapter info
Shows your active local IP — wlan0 for Wi-Fi, rmnet for cellular.
ip route get 8.8.8.8
# 8.8.8.8 via 192.168.0.1 dev wlan0 src 192.168.0.105
# Your phone IP is 192.168.0.105Process management & task control
ps — list running processes
ps -A | grep atlastop — real-time process monitor
Live CPU and memory usage by active task. Exit with CTRL+C on the hacker keybar.
kill — terminate a stuck process
kill -9 14205Local server & archiving utilities
Local web server
8080http://localhost:8080http://<phone-ip>:8080Archiving with zip & tar
- Compress a folder:
zip -r project_backup.zip my_project/ - Extract an archive:
unzip project_backup.zip - Create a tarball:
tar -czvf backup.tar.gz my_project/
Pipes, streams & text processing
| Operator | Action | Example | Explanation |
|---|---|---|---|
| | Pipe | ls -la | grep py | Feeds ls output into grep to filter Python files. |
> | Redirect (overwrite) | echo "Hello" > file.txt | Writes text to a file, replacing existing content. |
>> | Redirect (append) | echo "Log entry" >> log.txt | Appends text to the end of a file. |
&& | Chain (AND) | mkdir test && cd test | Runs the second command only if the first succeeds. |
; | Chain (sequential) | date ; whoami | Runs both commands regardless of success. |
grep — pattern search
- Search text in a file:
grep "def main" script.py - Case-insensitive:
grep -i "error" server.log - Recursive:
grep -rn "TODO" .
head & tail — file peeking
- First 10 lines:
head -n 10 server.log - Last 20 lines (logs):
tail -n 20 server.log
Tactile hacker keybar cheat sheet
| Key | Terminal action | Developer workflow |
|---|---|---|
TAB | Autocomplete | Type cd my_, tap TAB → expands to cd my_project/. |
ESC | Escape | Exits insert mode in vi or closes an open prompt. |
CTRL | Control modifier | CTRL then C sends SIGINT to break a frozen loop. |
| | Pipe stream | Inserts | instantly, no symbols mode. |
~ | Home directory | cd ~/ from any depth of folders. |
&& | Command chaining | gcc main.c && ./a.out — compile and run in one line. |
End-to-end examples
Spin up a test server and check it
# 1. Create a project folder
mkdir ~/web_test && cd ~/web_test
# 2. Generate a simple index page
echo "<h1>Welcome to ATLAS-OS by Nafiul Ahmad Rafi</h1>" > index.html
# 3. Verify files
ls -l
# 4. Check network availability
ping -c 2 8.8.8.8Monitor memory & process load
# 1. Inspect live memory status
free -m
# 2. Check storage headroom
df -h
# 3. View top active processes
ps -A | head -n 6