Shell commands

aurora-shell's commands, for scripts and your own shortcuts

With Aurora Shell running, aurora-shell COMMAND asks it to do something, which is handy in scripts and for your own shortcuts (Settings → Keyboard → Shortcuts → Add, with the command). Without a command, aurora-shell starts the shell (the session does this).

Command	What it does
`aurora-shell launcher [spotlight\|grid]`	Open Spotlight search, or Launchpad with `grid`.
`aurora-shell search TEXT`	Open Spotlight with TEXT already typed.
`aurora-shell dictate`	Start or stop dictation.
`aurora-shell read-aloud`	Read the selected text aloud.
`aurora-shell assistant`	Open the Aurora Assistant with the keyboard.
`aurora-shell writing`	Writing Tools for the selected text.
`aurora-shell overview`	Show all open windows.
`aurora-shell osk [show\|hide\|toggle]`	Show or hide the on-screen keyboard.
`aurora-shell show-desktop`
`aurora-shell snap-layouts`	Show Snap Layouts for the focused window.
`aurora-shell always-on-top`	Keep the focused window above the others, or stop.
`aurora-shell snap ZONE`	Put the focused window in a zone: `left`, `right`, `left-third`, `center-third`, `right-third`, `top-left` … `bottom-right`.
`aurora-shell clipboard`	Clipboard history in Spotlight.
`aurora-shell emoji`	The emoji picker in Spotlight.
`aurora-shell volume up\|down\|mute`	Change the volume, with the on-screen indicator.
`aurora-shell brightness up\|down`	Change the screen brightness.
`aurora-shell screenshot [area\|text\|pin]`	Screenshot of the screen or of an area, copy the text in an area, or pin an area to the screen.
`aurora-shell record [area] [sound]`	Start or stop screen recording: the whole screen, or an area you draw; with the computer's sound.
`aurora-shell colorpick`	Pick a color from the screen; its hex code is copied.
`aurora-shell shortcuts`	Show every keyboard shortcut.
`aurora-shell edit-widgets`	Edit the desktop widgets.
`aurora-shell keep-awake`	Turn Keep Awake on or off.
`aurora-shell quick-settings [hide]`	Open or close the Control Center; hide closes it and the notification center.
`aurora-shell logout`	Log out.
`aurora-shell focus`	Start or stop a focus session.
`aurora-shell minimize APP-ID`	Minimize an app's windows.
`aurora-shell windows`	Print the open windows as JSON, one per line (for scripts and tests).

Example: a shortcut that snaps the window to the right third runs aurora-shell snap right-third.