Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/damianiglesias/amnesiaOS/llms.txt

Use this file to discover all available pages before exploring further.

AmnesiaOS includes BusyBox 1.35.0 — a single statically-linked binary that provides over 300 Unix utilities. The following utilities are symlinked in /bin/ and available from the shell immediately after boot.
All commands listed below are symlinks pointing to /bin/busybox. BusyBox reads argv[0] to determine which applet to run. Running /bin/busybox --list in a live AmnesiaOS session shows the full list of applets compiled into the binary — many more than the symlinked subset documented here.

Available Utilities

CommandDescription
shPOSIX-compatible shell — the interactive environment you land in after boot.
echoPrint a line of text to standard output.
catConcatenate and print files to standard output.
grepSearch for lines matching a regular expression pattern.
sedStream editor for filtering and transforming text.
awkPattern-scanning and text-processing language for column-oriented data.
headPrint the first N lines of a file (default: 10).
tailPrint the last N lines of a file, with optional follow mode (-f).
morePage through text output one screen at a time (forward-only).
lessScroll through text output forward and backward.
viMinimal vi-compatible text editor for in-session file editing.
CommandDescription
lsList directory contents with optional formatting and sorting flags.
cpCopy files and directories.
mvMove or rename files and directories.
rmRemove files or directories.
mkdirCreate one or more directories, optionally with parent paths (-p).
findSearch the filesystem tree for files matching name, type, or attribute criteria.
chmodChange file or directory permission bits.
chownChange the owner and group of a file or directory.
lnCreate hard or symbolic links between files.
pwdPrint the absolute path of the current working directory.
tarCreate, list, or extract tar archive files.
gzipCompress files using the gzip (DEFLATE) algorithm.
gunzipDecompress gzip-compressed files.
CommandDescription
psReport a snapshot of currently running processes.
killSend a signal to a process by PID (default: SIGTERM).
topDisplay a live, auto-refreshing table of running processes and resource usage.
dfReport available and used disk (filesystem) space.
freeDisplay total, used, and available physical memory and swap.
unamePrint system information such as kernel version and architecture.
dateDisplay or set the system date and time.
sleepPause execution for a specified number of seconds.
dmesgPrint or control the kernel ring buffer (boot and driver messages).
hostnameDisplay or set the system hostname.
CommandDescription
mountMount a filesystem, attaching it to the directory tree at a specified mount point.
umountUnmount a previously mounted filesystem, detaching it from the directory tree.
CommandDescription
ipConfigure and display network interfaces, routing tables, and tunnels (iproute2-compatible).
ifconfigDisplay or configure network interface parameters (legacy net-tools style).
pingSend ICMP ECHO_REQUEST packets to a host to test network reachability.
wgetNon-interactive network downloader supporting HTTP and FTP.
udhcpcBusyBox DHCP client — used by the init script to obtain an IP address, gateway, and DNS configuration via DHCP.
CommandDescription
suSwitch to another user account (or root) within the current shell session.
loginBegin a new login session, prompting for username and password.
CommandDescription
basenameStrip directory path and an optional suffix from a filename, returning only the final component.

Using BusyBox Applets

Every utility can be invoked either via its /bin/ symlink or directly through the busybox <applet> syntax. Both forms are equivalent.
busybox ls -la /
busybox ip addr show
This is particularly useful when a symlink does not exist for an applet that is compiled into the binary, or when you want to be explicit about which binary is running the command.

Applet Help

Every BusyBox applet supports a --help flag that prints a concise usage summary.
busybox applet --help
# or, using the symlink directly:
applet --help
For example:
busybox udhcpc --help
ip --help
tar --help
Run busybox --list to see every applet compiled into the AmnesiaOS BusyBox binary. The symlinked subset documented above covers the most commonly used commands, but the full binary includes many additional applets such as httpd, ftpget, nc, xxd, hexdump, and more.

Build docs developers (and LLMs) love