GitHunt
EQ

Official command-line interface for managing Aureli

Aureli CLI

โ€œYour desktop, your rules. Full control at your fingertips.โ€


๐Ÿ“Œ Overview

Aureli CLI is the command-line interface for Aureli โ€” the next-generation Linux desktop shell and environment.
It allows you to launch, control, and configure every aspect of Aureli, from panels and launchers to dialogs, notifications, and Notch apps.

With Aureli CLI, you can:

  • Start, restart, or quit the Aureli shell.
  • Lock your screen or open the notification center.
  • Configure settings dynamically.
  • Create and manage Notch apps (dynamic popups and mini-apps).
  • Launch dialogs with fully customizable content and behavior.

โšก Installation

Make sure you have Python 3 installed. Install it by cloning the repo:

git clone https://github.com/eq-desktop/cli.git
cd cli/
./install.sh

๐Ÿš€ Usage

au <command> [arguments]

Available Commands

Command Description
run Start Aureli
install Install Aureli
lock Lock the screen
settings Open settings panel
update Check for updates (not yet implemented)
launchpad Open the Launchpad
new_notch_app <file> <title> Create a new Notch app
destroy_notch_app Forcefully quit a Notch app
dialog <appName> <iconPath> <title> <description> <accept> <decline> <commandAccept> <commandDecline> <customStyle> Open a customizable dialog
notification_center Open the notification center
quit Quit Aureli
restart Restart Aureli
set <setting> <value> Set a specific setting (e.g., bar.height)
get <setting> Get the value of a setting
reset <setting> [--all] Reset a setting or all settings

๐Ÿ›  Configuration

Aureli CLI reads and writes settings directly to Aureli Shell:

  • Set values dynamically:

    au set bar.height 22
  • Get current values:

    au get bar.height
  • Reset a specific setting or all settings:

    au reset bar.height
    au reset --all

๐Ÿ”ง Development

Aureli CLI is built in Python 3 and designed to integrate seamlessly with the Aureli shell.
Feel free to fork, contribute, or extend the CLI to suit your needs.


โš–๏ธ License

Released under the MIT License.
You are free to use, modify, and distribute this software as you wish.

Languages

Python99.0%Shell1.0%

Contributors

MIT License
Created September 22, 2025
Updated February 2, 2026