data-peek

!GitHub Downloads (all assets, all releases) (https://img.shields.io/github/downloads/Rohithgilla12/data-peek/total?style=for-the-badge)

A minimal, fast SQL client desktop application with AI-powered querying. Built for developers who want to quickly peek at their data without the bloat. Supports PostgreSQL, MySQL, and Microsoft SQL Server.

Screenshots

AI Assistant - Generate charts and insights

AI Assistant - Natural language to SQL

ER Diagrams - Visualize relationships

Command Palette - Quick actions

Light Mode

Features

• AI Assistant - Ask questions in plain English, get SQL queries. Generate charts and insights (BYOK)
• Fast - Opens in under 2 seconds, low memory footprint
• Query Editor - Monaco editor with SQL syntax highlighting and autocomplete
• Command Palette - Cmd+K to access everything instantly
• Multi-tab Support - Work with multiple queries simultaneously
• Inline Editing - Edit table data directly with INSERT/UPDATE/DELETE
• ERD Visualization - See table relationships visually
• Query Plans - Analyze query performance with EXPLAIN ANALYZE viewer
• Saved Queries - Bookmark your favorite queries for quick access
• Dark/Light Mode - Easy on the eyes
• Keyboard-First - Power users shouldn't need a mouse
• Secure - Connection credentials encrypted locally, no telemetry

Installation

Download

Download the latest release for your platform from Releases (https://github.com/Rohithgilla12/data-peek/releases).

• macOS: .dmg (Intel & Apple Silicon)
• Windows: .exe installer
• Linux: .AppImage, .deb, or .tar.gz (Arch)

macOS: "App is damaged" Fix

Since the app isn't notarized with Apple yet, macOS Gatekeeper may show a warning. To fix:

Option 1: Terminal command

xattr -cr /Applications/data-peek.app

Option 2: Right-click to open

1. Right-click (or Control+click) on data-peek.app
2. Select "Open" from the menu
3. Click "Open" in the dialog

This only needs to be done once. Proper code signing is coming soon!

Linux: Auto-Updates

Auto-updates only work with the AppImage format. If you installed via .deb or .tar.gz, you'll need to manually download new releases from the Releases page (https://github.com/Rohithgilla12/data-peek/releases).

For the best experience with automatic updates, we recommend using the AppImage.

Build from Source

# Clone the repository
git clone https://github.com/Rohithgilla12/data-peek.git
cd data-peek

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for your platform
pnpm build:mac    # macOS
pnpm build:win    # Windows
pnpm build:linux  # Linux

Troubleshooting: Electron not found

If you get errors about Electron not being found after pnpm install:

# Option 1: Run the setup script
pnpm setup:electron

# Option 2: Rebuild native modules
pnpm rebuild

# Option 3: Clean install (nuclear option)
pnpm clean:install

This can happen when pnpm's cache skips Electron's postinstall script that downloads platform-specific binaries.

Tech Stack

Project Structure

apps/
  desktop/     # Electron desktop application
  web/         # Marketing website + licensing
packages/
  shared/      # Shared types for IPC

Development

# Install dependencies
pnpm install

# Start desktop app with hot reload
pnpm dev

# Start web app
pnpm dev:web

# Lint all workspaces
pnpm lint

# Build desktop app
pnpm build

Star History

License

MIT License - see LICENSE for details.

Pre-built binaries require a license for commercial use. See the license file for details on free vs. commercial use.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Support

• GitHub Issues (https://github.com/Rohithgilla12/data-peek/issues) - Bug reports and feature requests
• GitHub Sponsors (https://github.com/sponsors/Rohithgilla12) - Support development
• Twitter/X: @gillarohith (https://x.com/gillarohith)