Skip to main content
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.
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.

​
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
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.