Installation

Desktop app

Pre-built binaries

Download the latest version for your platform:

Platform	Format	Download
macOS (Apple Silicon)	.dmg	Gunsole_0.2.0_aarch64.dmg
macOS (Intel)	.dmg	Gunsole_0.2.0_x64.dmg
Windows	—	Coming soon
Linux	.AppImage	Gunsole_0.2.0_amd64.AppImage
Linux	.deb	Gunsole_0.2.0_amd64.deb

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

---

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: "local",
});

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.