Tools
All tools
DesktopBeta

Lagsense

A desktop app that reads your system health and explains what is wrong in plain English

Choose your platform (v0.1.5)

Windows .exeLinux .AppImageLinux .debmacOS .dmg
Star on GitHub · 1

What it does

Lagsense is an AI powered system diagnostics assistant for understanding and troubleshooting PC performance issues. It is built with Electron, React, TypeScript and Tailwind CSS.

It uses the OpenAI SDK and defaults to OpenAI's endpoint, but it is a stock OpenAI compatible client, so you can point it at any OpenAI compatible provider by changing the base URL in Settings.

Early scaffold. The diagnosis flow currently sends a placeholder system snapshot to the model. Real metric collection (CPU, RAM, disk, and journalctl or dmesg on Linux, with Windows equivalents) is not wired up yet.

Features

  • API key, base URL and model configurable from an in app Settings screen
  • Works with OpenAI or any OpenAI compatible provider
  • API key stored with Electron safeStorage (OS level encryption), never localStorage
  • One click system diagnosis with a plain English explanation
  • Persistent local diagnosis history and a clear logs option
  • Light and dark themes
  • Desktop app for Linux, Windows and macOS
  • Typed Electron IPC between the renderer and main process

Install

Download the latest version from the GitHub Releases page, or use the download button above.

Linux

Two packages are provided: an .AppImage for a portable install and a .deb for Debian and Ubuntu.

sudo apt install ./lagsense-0.1.0.deb

chmod +x lagsense-0.1.0.AppImage
./lagsense-0.1.0.AppImage

Windows

Download the Windows installer from the latest release and run it.

macOS

Download the .dmg, open it and move Lagsense to the Applications folder.

Tech stack

Electron, vite-plugin-electron, React, TypeScript, Tailwind CSS, Vite, Electron Builder and the OpenAI SDK.

Run it from source

You need Node.js 20+ and npm 10+.

git clone https://github.com/MalahimHaseeb/lagsense.git
cd lagsense
npm install
cp .env.example .env
npm run dev

The .env file is optional. It only changes the default base URL and model shown in Settings on first launch.

Releases

Tagging a commit on main with a version like v0.1.0 triggers GitHub Actions to build Linux, Windows and macOS installers and attach them to the release. The repo uses a feature, developer, main branch flow, described in CONTRIBUTING.md.