Getting started

Desktop app

Download the Electron control center from the same tagged GitHub Releases that publish the CLI.

The desktop app is a thin Electron shell over the shared codel00p protocols. It signs in through the browser, reads cloud dashboard data through @codel00p/sdk, and connects to local sessions through the installed codel00p CLI.

Downloads

Platform	Asset	Notes
macOS Apple silicon	codel00p-desktop-aarch64-apple-darwin.dmg	For M-series Macs.
macOS Intel	codel00p-desktop-x86_64-apple-darwin.dmg	For Intel Macs.
Linux x86-64	codel00p-desktop-x86_64-unknown-linux-gnu.AppImage	Mark executable before launching.
Linux arm64	codel00p-desktop-aarch64-unknown-linux-gnu.AppImage	For arm64 Linux desktops.
Windows x86-64	codel00p-desktop-x86_64-pc-windows-msvc.exe	Runs the NSIS installer.

Note

Each desktop asset also has a matching .sha256 sidecar in the GitHub Release. macOS builds are unsigned for now, so Gatekeeper may require an explicit open from Finder.

Linux launch

chmod +x codel00p-desktop-x86_64-unknown-linux-gnu.AppImage
./codel00p-desktop-x86_64-unknown-linux-gnu.AppImage

Release process

Desktop installers are built by .github/workflows/release.yml when a v* tag is pushed. The workflow runs Electron Builder for each supported platform, then normalizes the output to the stable asset names above before the final GitHub Release publish step.

Bump apps/desktop/package.json when the desktop app changes.
Commit the version change and push a vX.Y.Z tag, matching the CLI release convention.
The release workflow uploads both the installer and its .sha256 checksum sidecar.