Installation

Desktop app

Pre-built binaries

Pre-built binaries for macOS, Windows, and Linux are coming soon. For now, build from source.

Build from source

You need the Rust toolchain, Node.js 18+, and pnpm.

# Install Rust (if you don't have it)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/nicholasgriffintn/gunsole.git
cd gunsole/apps/desktop
pnpm install
pnpm tauri dev     # development mode
pnpm tauri build   # production build

Platform-specific prerequisites (system libraries for Tauri) are documented in the Tauri v2 prerequisites guide.

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

JavaScript / TypeScript

pnpm add gunsole-js
# or
npm install gunsole-js
# or
yarn add gunsole-js

The SDK works in browsers and Node.js. Zero dependencies — it only uses the built-in Fetch API.

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.