Installation

Desktop app

Pre-built binaries

Download the latest version for your platform:

Platform	Format	Download
macOS (Apple Silicon)	.dmg	Gunsole-0.3.0-arm64.dmg
macOS (Intel)	.dmg	Gunsole-0.3.0.dmg
Windows (x64)	.exe	Gunsole-0.3.0-setup.exe
Linux	.AppImage	Gunsole-0.3.0-x86_64.AppImage
Linux	.deb	Gunsole-0.3.0-amd64.deb

macOS builds are code-signed and notarized. The Windows build is unsigned for now, so expect a SmartScreen prompt — click “More info” → “Run anyway”.

Gunsole auto-updates itself once installed, so you only need to do this once.

Where data lives

Gunsole stores its SQLite database at:

OS	Path
macOS	~/Library/Application Support/gunsole/gunsole.db
Linux	~/.local/share/gunsole/gunsole.db
Windows	%APPDATA%\gunsole\gunsole.db

Building from source

pnpm install
cd apps/desktop && pnpm package

Repo: github.com/push1kb/gunsole-monorepo.

---

SDK

@gunsole/web

For code that runs in the browser — React, Angular, Solid, Vue, Next.js client components:

pnpm add @gunsole/web

@gunsole/core

For code that runs on the server — Node.js backends, Next.js server components, API routes, CLI tools:

pnpm add @gunsole/core

SSR frameworks (Next.js, Nuxt, etc.) — use both. See the Next.js guide for a full example with client and server setup.

Quick start

import { createGunsoleClient } from "@gunsole/web";

const gunsole = createGunsoleClient({
  projectId: "my-app",
  mode: "desktop",
});

gunsole.info({ bucket: "test", message: "Hello from Gunsole!" });

See it appear in the desktop app — the project and bucket are auto-created.

Other languages

Python and Kotlin SDKs are planned but not yet available. The HTTP API is simple enough to hit directly if you need to send logs from another language. See the REST API docs.