boredos_mirror/docs/usage/terminal.md

Terminal & Command Line

The BoredOS Terminal provides a powerful command-line interface (CLI) for advanced users and developers. It supports standard Unix-like features and provides direct access to the kernel's system calls.

The Shell

The default shell in BoredOS is BoredShell (Bsh), a userspace shell with a dedicated terminal app. It features:

• ANSI Color Support: Rich text output with colors and styles.
• Command History: Use the Up and Down arrow keys to navigate through your previous commands (up to 64 history entries).
• Output Redirection:
  • command > file: Write output to a new file (or overwrite existing).
  • command >> file: Append output to an existing file.
• Piping:
  • command1 | command2: Pass the output of the first command as input to the second.

Bsh Configuration

Bsh loads its configuration from:

/Library/bsh/bshrc

This file is similar to .zshrc or .bashrc and can define:

• PATH for command lookup
• STARTUP for interactive shell startup scripts
• BOOT_SCRIPT for a once-per-boot script
• prompt templates (PROMPT_LEFT, PROMPT_RIGHT)

Prompt tokens:

• %n username
• %h hostname
• %~ cwd ("~" for /root)
• %T time (HH:MM)

Example:

PATH=/bin:/root/Apps
PROMPT_LEFT=%n@%h:%~$ 
STARTUP=/Library/bsh/startup.bsh
BOOT_SCRIPT=/Library/bsh/boot.bsh

Common Commands

Below are some of the most used commands available in /bin:

Command	Description
ls	List files and directories in the current path.
cd	Change the current working directory.
cat	Display the contents of a file.
ls	List directory contents.
rm	Remove a file.
mkdir	Create a new directory.
man	View the manual for a specific command (e.g., man ls).
lsblk	List block devices and partitions with size, type, filesystem, label, and flags.
sysfetch	Display system and hardware information.

---

Return to Documentation Index