https://github.com/emanuele-em/cove

An extensible, multi-database GUI client for macOS — add any database by implementing a single Swift protocol. Built for contributors.
https://github.com/emanuele-em/cove

contributions-welcome database extensible gui hacktoberfest macos open-source swift swiftui

Last synced: about 2 months ago
JSON representation

An extensible, multi-database GUI client for macOS — add any database by implementing a single Swift protocol. Built for contributors.

• Host: GitHub
• URL: https://github.com/emanuele-em/cove
• Owner: emanuele-em
• License: mit
• Created: 2026-03-15T14:39:53.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-05-02T10:12:15.000Z (about 2 months ago)
• Last Synced: 2026-05-02T11:22:30.147Z (about 2 months ago)
• Topics: contributions-welcome, database, extensible, gui, hacktoberfest, macos, open-source, swift, swiftui
• Language: Swift
• Size: 43.9 MB
• Stars: 168
• Watchers: 2
• Forks: 9
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# Cove

[![Build](https://github.com/emanuele-em/cove/actions/workflows/build.yml/badge.svg)](https://github.com/emanuele-em/cove/actions/workflows/build.yml)

[![Download](https://img.shields.io/github/v/release/emanuele-em/cove?label=Download&style=flat)](https://github.com/emanuele-em/cove/releases/latest)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

[![macOS 15+](https://img.shields.io/badge/macOS-15%2B-000000.svg?logo=apple)](https://developer.apple.com/macos/)

[![Swift 6](https://img.shields.io/badge/Swift-6-F05138.svg?logo=swift&logoColor=white)](https://swift.org)

A native macOS database client. Fast, lightweight, extensible.

![Cove demo](docs/hero.gif)

### Supported databases

  

    
PostgreSQL

    
MySQL

    
MariaDB

    
SQLite

    
MongoDB

    
Redis

    
ScyllaDB

  

  

    
Cassandra

    
Elasticsearch

    
Oracle

    
SQL Server

    
ClickHouse

    
DuckDB

  

Adding a new backend requires zero changes to UI code — see [`DB/README.md`](Cove/DB/README.md).

## Features

- **Browse** schemas, tables, views, indexes, and keys in a sidebar tree

- **Edit rows** inline with SQL/CQL preview before commit

- **Run queries** with syntax highlighting and autocomplete

- **Agent Mode** — generate or edit queries with Claude Code or Codex CLI

- **Multiple tabs** with independent connections (Cmd+T)

- **Connection environments** — local, dev, staging, production

- **SSH tunneling** — password or private key authentication

- **SQLite over SSH** — browse and query a VPS-hosted SQLite file from the same SQLite connection flow

- **Session persistence** — connections and tabs restore across app relaunches

- **Color-coded indicators** and connection tooltips

- Native macOS UI — no Electron, no web views

## Agent Mode

Agent Mode can create a new query or edit the current query block using a local agent CLI.



- Hover a selected query block or an empty editor line, then click **agent mode**

- Press **Cmd+K** to open Agent Mode at the cursor

- Press **Cmd+Return** from the Agent Mode prompt to generate

- Press **Esc** or the close button to close Agent Mode

Cove currently supports:

- **Claude Code** via the `claude` CLI

- **Codex CLI** via the `codex` CLI

The selected agent receives the current query block, the active backend and database metadata, the loaded browser tree, and completion schema context. Cove does not send database passwords to the agent prompt.

Agent processes run locally from Cove's Application Support workspace. macOS may still show a Documents folder permission prompt if the underlying CLI tries to access a protected folder, especially when developing or launching Cove from a repository inside `~/Documents`.

## Install

Download the latest `.dmg` from [Releases](https://github.com/emanuele-em/cove/releases/latest).

> On first launch, macOS may block the app. Right-click the app and select **Open** to bypass Gatekeeper.

Or build from source:

```bash

# One-time Xcode setup, if needed

xcodebuild -runFirstLaunch

xcodebuild -scheme Cove -derivedDataPath .build build

open .build/Build/Products/Debug/Cove.app

```

If `xcodebuild` fails because Xcode has not completed setup on your machine, run `xcodebuild -runFirstLaunch` once and retry.

Requires macOS 15+.

## Roadmap

Contributions welcome:

- Import/export (CSV, JSON, SQL)

- Data filtering and search

- Query history panel

- SSL/TLS certificate configuration UI

- Query explain/analyze visualization

- Homebrew cask

## Community

- [Bug reports](https://github.com/emanuele-em/cove/issues/new?template=bug_report.md)

- [Feature requests](https://github.com/emanuele-em/cove/issues/new?template=feature_request.md)

- [Contributing guide](CONTRIBUTING.md)

- [Security policy](SECURITY.md)

- [Code of Conduct](CODE_OF_CONDUCT.md)

## License

[MIT](LICENSE)