Logs with shape, not noise.

Gunsole is a desktop log viewer plus JS/TS SDK with workspace/project/bucket hierarchy, dynamic tag filtering, and local REST + MCP interfaces.

Get Started Install + Download

Source-backed from your repos: gunsole-monorepo and gunsole-js.

Tauri 2 + React 19 SDK 0.1.0 Desktop 0.1.0 MCP Tools x4

Why teams keep this open

Hierarchy that matches real work

Workspace → Project → Bucket keeps streams navigable as log volume grows.

Dynamic tags without ceremony

Tag keys/values are discovered and indexed server-side, including log_level as a system tag.

SDK tuned for apps, not demos

Automatic batching, interval flush, retries, and explicit control via flush().

Agent-ready local surfaces

REST endpoints for project and logs, plus MCP over JSON-RPC at /mcp.

Fast path

# 1) Run desktop
git clone https://github.com/push1kb/gunsole-monorepo.git
cd gunsole-monorepo
pnpm install
cd apps/desktop
pnpm tauri dev

# 2) In your app
pnpm add gunsole-js

import { createGunsoleClient } from 'gunsole-js';

const gunsole = createGunsoleClient({
  projectId: 'my-project',
  apiKey: 'dev-key',
  mode: 'desktop',
  env: 'development',
  defaultTags: { service: 'web' }
});

gunsole.info({
  bucket: 'checkout',
  message: 'Submit clicked',
  tags: { flow: 'purchase', stage: 'submit' },
  traceId: 'checkout-req-8842'
});