> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uos.agency/llms.txt
> Use this file to discover all available pages before exploring further.

# terminal

> A command-line interface for uOS, with a built-in AI mode

The uOS Terminal is a command-line interface for controlling the desktop: open apps, manage windows, change appearance, and inspect the in-browser file system. It also has a built-in **AI mode** so you can ask questions in plain English without leaving the prompt.

<Note>
  The file system is an in-browser sandbox (it resets with `reset-fs`), and wallet/token actions run against the same on-chain flows the desktop apps use. This is not a real Unix shell; the commands below are the ones that actually work.
</Note>

## Commands

#### General

* `help`: List available commands
* `about`: Terminal version and info
* `version`: Show the uOS version
* `clear`: Clear the screen
* `explain <command>`: Explain what a command does
* `quit`: Close the terminal window

#### AI mode

* `uOS-assistant`: Enter AI chat mode; ask questions in natural language
* `uOS-assistant <question>`: Enter AI mode and send a question immediately

#### File system (sandbox)

* `pwd`: Print working directory
* `ls`: List directory contents
* `cd`: Change directory
* `cat`: Display file contents
* `touch`: Create an empty file
* `mkdir`: Create a directory
* `rm`: Remove a file or directory
* `reset-fs`: Reset the sandbox file system to its default state

#### Windows & apps

* `open <app>`: Launch an app (`appstore`, `browser`, `terminal`, `settings`)
* `apps`: List available apps
* `windows`: List open windows
* `focus <window>`: Bring a window to the front
* `close <window>`: Close a window

#### Processes

* `ps`: List running processes
* `kill`: Terminate a process

#### System & appearance

* `system info`: Show system information
* `system status`: Show system status
* `theme <light|dark>`: Switch the theme
* `font <size>`: Adjust the font size
* `animations`: Toggle interface animations
* `restart`: Restart uOS
* `whoami`: Show the current user
* `date`: Show the current date and time

#### Wallet & tokens

* `wallet status`: Show wallet connection status
* `wallet connect`: Prompts you to connect via the button in the top-right
* `token create`: Start a token deployment
* `token create --wizard`: Launch the guided token-creation wizard

<Tip>
  Type `uOS-assistant` to drop into AI mode, then ask things like "what's in this directory?" or "how do I open the app store?" and the assistant answers inline.
</Tip>