Skip to content

README.md

Latest commit

 

History

History
125 lines (88 loc) · 3.53 KB

README.md

File metadata and controls

125 lines (88 loc) · 3.53 KB
Raw

AmmOS — Free Pseudo-OS (x86-64)

AmmOS is an experimental modular shell-driven system for fun, learning, and low-level control.

  • License: MIT License
  • Purpose: Educational and experimental
  • Supported platforms: Linux (Debian, Ubuntu, WSL2, etc.)
  • Compile: Run ./make.sh in the project root
  • Run: Execute ./run in the project root

Dependencies:

  • nasm
  • gcc

💻 CLI Commands

All commands are implemented in AmmSH_execute(). Arguments are space-separated.
Flags and preprocessing are handled by parseFlags() and preprocessor().

⚙️ System

Command Description
c Clear screen using ANSI escape codes
ex Exit AmmOS and return to the host shell
sleep [seconds ...] Pause execution (supports multiple arguments)
getlogin Print the current username
neofetch Display AmmOS system information
reboot Restart AmmOS using execl()
chg -un <username> Change current username (requires reboot to take effect)
memreg Print memory usage, RAM, HDD, and amm_malloc statistics

📂 File & Directory

Command Description
ls List current directory contents
mkdir [dirname ...] Create directory(ies)
go [dirname] Change current directory
touch [filename ...] Create an empty file
nano [filename] Open a file using /bin/nano
r [filename ...] Print file contents (like cat)
rf [filename ...] Remove file(s)
rm [dirname ...] Remove a directory and all its contents recursively

🔍 Search

Command Description
agrep -r-file <filename> [& start_dir] Recursively search for a file starting from a directory
agrep -r-str <filename> <pattern> [& start_dir] Search for a string pattern in a file recursively
agrep -r-file-str <filename> <pattern> [& start_dir] Search for a file containing a pattern recursively

🧮 ASM Programs

Command Description
calc Simple calculator (assembly)
fib Print Fibonacci numbers (assembly, supports high values)
fac Calculate factorial

🧱 AmmIDE (Bytecode Editor)

Command Description
AmmIDE Enter the bytecode editor
Inside AmmIDE: push <0-256> – Push ASCII value to stack (disk.dat)
free – Pop last ASCII character from stack
read – Load and print stack as ASCII characters

📦 Disk & Memory

Command Description
diskload Load stack from disk.dat and print it
memload Print memory allocated using amm_malloc()

🖥️ VGA

Command Description
gpu Enter VGA text drawing mode (mov [WIDTH] [HEIGHT] [CHAR])

👻 Daemons (asystemd)

Command Description
asystemd start <file.ammservice> Start a daemon from .ammservice file
asystemd kill <apid> Kill a daemon by apid
asystemd list List all running daemons with metadata

📢 Output

Command Description
say [text ...] Print each argument as a new line (custom echo)

🛠 Coming soon...

More tools, shell commands, and services will be added in future versions of AmmOS.

AmmOS is self-documented through its codebase.
For available CLI commands, see AmmSH_execute() in AmmSH.c.