CLI Usage

CLI Usage

The SYSTEM is a desktop application. These are the commands and flags for launching it.

Launching the desktop app

uv run system-sl

Or, if installed globally:

system-sl

On first launch an LLM Settings dialog asks for the chatbot provider, model and API key. The settings are saved to llm_config.json in the system-sl data directory, and the API key to your system keyring. Change them later under Settings → LLM.

Background notifier mode

uv run system-sl --bg

This runs only the hourly task notifier — it never opens the main menu. This is the mode used by the autostart entry. See Background Service.

Desktop integration (AppImage)

./system-sl-*.AppImage --install-desktop

Moves the AppImage to ~/Applications and adds a menu entry for it. Settings → Install App does the same from inside the running AppImage.

Checking a build

system-sl --check-ocr [report-file]
system-sl --check-gui [report-file]
system-sl --check-theme [report-file]

--check-ocr reads a generated scanned PDF. --check-gui opens the main window, loads a notification sound, and confirms the Google Tasks API description is present. --check-theme runs the bundled wallust on a generated image and verifies that it produces a complete Dynamic palette. Each exits with 0 on success. They print the result and also write it to report-file if you give one, which is the only way to see it on Windows.

Building a standalone executable

uv run build-sl

Produces a one-file executable in dist/. See Building and Releasing.