<img src="assets/logo/openmango-1024.png" width="128" alt="OpenMango logo" /> <h1 align="center">OpenMango</h1> GPU-accelerated MongoDB client for macOS No Electron. No web views. Just fast. <a href="https://github.com/ggagosh/openmango/releases/latest"><img src="https://img.shields.io/github/v/release/ggagosh/openmango?label=release" alt="Latest Release" /></a> <a href="https://github.com/ggagosh/openmango/actions/workflows/ci.yml"><img src="https://github.com/ggagosh/openmango/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="https://github.com/ggagosh/openmango/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-blue.svg" alt="License: GPL-3.0" /></a> <img src="https://img.shields.io/badge/platform-macOS-lightgrey.svg" alt="Platform: macOS" /> <img src="assets/initial.gif" width="800" alt="OpenMango demo" />

Install

Download the latest release — signed and notarized for macOS (Apple Silicon & Intel).

OpenMango includes a built-in auto-updater so you'll always be on the latest version.

Or build from source if you prefer.

Features

Forge Shell

Built-in query shell powered by a Bun/TypeScript sidecar with mongosh-compatible syntax, schema-aware completions, and inline results.

Aggregation Builder

Visual pipeline editor — add/reorder/toggle stages, preview intermediate results, and copy the pipeline as code.

Schema Explorer

Sample documents to discover field types, cardinality, type drift, and outliers across your collection.

Document Browser

Filter, sort, project, and paginate documents. Edit fields inline in the tree view or open the full JSON editor with validation.

Transfer System

Import and export JSON, NDJSON, CSV, and BSON. Copy documents between collections or databases with progress tracking.

Explain Plan

Visualize the winning query plan, index usage, scanned-vs-returned doc counts, and stage costs.

Connectivity

Standard connections, SRV records, SSH tunneling, and SOCKS5 proxy support. Connection import/export with optional encryption.

Keyboard-First

40+ keybindings for navigation, tabs, editing, and search. Everything is reachable without a mouse.

Themes

15 built-in themes — Vercel Dark, OpenMango Islands (Dark & Light), Darcula, Tokyo Night, Nord, One Dark, Catppuccin (Mocha & Latte), Solarized (Dark & Light), Rosé Pine (Dark & Dawn), and Gruvbox (Dark & Light).

See docs/features.md for the complete feature matrix.

Roadmap

Upcoming highlights from the full roadmap:

Index diagnostics and "why is this query slow" hints
Query history with restore
Saved query snippets and templates
Validation rule editor
Live server health panel
Change stream viewer
Split view (side-by-side tabs)

Architecture

OpenMango is a native macOS app written in Rust.

| Layer | Technology | |-------|-----------| | UI framework | GPUI — GPU-accelerated via Metal | | Async runtime | Tokio | | MongoDB driver | Official Rust driver (mongodb crate) | | Shell sidecar | Bun + TypeScript (mongosh-compatible) | | Packaging | Signed, notarized .app with auto-updater |

The entire UI runs on the GPU through Metal — no web views, no DOM, no CSS layout engine.

Development

Prerequisites: Rust (stable), just, MongoDB (local or remote), Docker (for integration tests), Bun (for the Forge sidecar)

git clone https://github.com/ggagosh/openmango.git
cd openmango
just dev

| Command | Description | |---------|------------| | just dev | Run in development mode | | just debug | Run with RUST_LOG=debug | | just check | Fast compile verification | | just lint | Clippy with warnings denied | | just fmt-check | Enforce formatting | | just test | Run all tests | | just ci | Local CI parity |

See CONTRIBUTING.md for the full contributor guide.

AI Disclosure

OpenMango is fully written by AI — architecture, implementation, tests, and tooling. Human-directed, machine-authored.

License

GPL-3.0

Openmango

Install / Use

README