ade-setup

Shell entry points and .desktop files for ADE sessions via adm.

Scripts

Script	Session	GUI env	Default
ade-wayland	Wayland	ADE_COMPOSITOR	Hyprland
ade-xlibre	X11 / XLibre	ADE_WM	i3

Shared lifecycle: bin/ade-session-lib.sh (start a-kerno → wait socket → GUI → shutdown).

For X11, adm starts the X server (XORG_BIN); these scripts only run a-kerno and the compositor/WM.

Debug nested Wayland

From an existing Wayland session (e.g. Hyprland on the host):

ade-wayland -debug-subsession
# or: ADE_DEBUG_SUBSESSION=1 ade-wayland

Uses isolated runtime /tmp/ade-{UID}-debug (override with ADE_RUNTIME_DIR). Host WAYLAND_DISPLAY is preserved; the nested compositor creates its own client socket automatically.

Debug exports all known daemon sockets under $ADE_RUNTIME_DIR (kerno, indexd, skripto, tondujo, dosierago). Config is read from ~/.config/ade-debug (ADE_CONFIG_HOME); on first run you are prompted to copy from ~/.config/ade (non-TTY: set ADE_DEBUG_COPY_CONFIG=1).

For Hyprland-in-Hyprland, use a separate compositor config (different mod key, no conflicting exec-once):

export ADE_COMPOSITOR="Hyprland --config ~/.config/hypr/hyprland-ade-debug.conf"
ade-wayland -debug-subsession

Ensure daemons.md in the debug config uses ${ADE_RUNTIME_DIR} for daemon socket paths (copied configs are rewritten automatically on first copy).

Install

Requires a-kerno and session GUI (Hyprland, i3, …) installed separately.

SUDO=sudo make install

Installs:

• /usr/local/bin/ade-wayland, ade-xlibre, ade-session-lib.sh
• /usr/local/share/wayland-sessions/ade.desktop
• /usr/local/share/xsessions/ade-xlibre.desktop

Check

make check

See also

• doc/ade-setup.md in the 0xADE monorepo
• a-kerno — daemon orchestrator