SurrealDB Client

The SurrealDB GUI Client for Mac.

A fast, native SurrealDB GUI client for Mac. Connects to SurrealDB 2.x and 3.x over the HTTP RPC protocol, with CBOR on the wire so record links, datetimes, durations, decimals, and UUIDs keep their types instead of arriving as plain strings. Browse namespaces and databases in the sidebar, run SurrealQL in the editor, and edit records inline in the data grid. Free and open source.

Download for Mac Read the docs

TablePro connected to a SurrealDB database showing the data grid and SQL editor

Features

Built for SurrealDB.

Namespace and Database Tree

Namespaces sit at the top of the sidebar, databases sit inside them, tables sit inside a database. Switch either level without reconnecting.

CBOR Typed Values

The driver talks CBOR, so record links, datetimes, durations, decimals, and UUIDs arrive typed. A record link shows as table:id, objects and arrays show as compact JSON.

Five Auth Levels

Sign in as Root, Namespace, Database, Record Access, or with a JWT you already hold, including SurrealDB Cloud. Record Access takes the name from DEFINE ACCESS.

Field-Level Record Editing

Changing a cell runs an UPDATE that sets only the fields you touched, so computed FUTURE fields and fields another writer changed are left alone. Values go out as typed parameters, never as SurrealQL.

Schemaless Column Inference

A SCHEMALESS table has no declared fields, so TablePro reads columns from the rows it fetched. A field only some records carry still gets a column.

SurrealQL Editor and AI

The Explain button runs the current query with EXPLAIN or EXPLAIN FULL to show how it resolves, for example whether an index is used. Ask the AI assistant in English and get SurrealQL back.

Data Grid

Browse and edit data.

Sort, filter, and edit SurrealDB data in a spreadsheet-like grid. Click any cell to edit. Insert and delete rows. Review changes before saving.

TablePro data grid showing SurrealDB table rows with inline editing

SQL Editor

Write queries faster.

Tree-sitter syntax highlighting, schema-aware autocomplete, multi-tab, Vim mode, and full-text query history. AI assistant can write, explain, or optimize your SQL.

TablePro SQL editor with SurrealDB query and autocomplete

Capabilities

What you can do.

Browse namespaces, databases, and tables
Run SurrealQL in the query editor
Edit records inline, one field per UPDATE
Sign in at root, namespace, database, record, or token level
Inspect plans with EXPLAIN and EXPLAIN FULL
Connect over HTTPS, SSH tunnel, or SOCKS5
Open surrealdb:// URLs from the browser or terminal
Safe mode for production servers

Connect

Get connected in seconds.

-- Connect with TablePro
-- Host: 127.0.0.1  Port: 8000
-- Auth Level: Root  Namespace: test  Database: app

SELECT * FROM person WHERE age > 18;

-- Transactions run as a single query in the editor
BEGIN TRANSACTION;
UPDATE person:tobie SET age = 31;
COMMIT TRANSACTION;

Supported versions

SurrealDB 2.x and 3.x (1.x is not supported)

Connection types

HTTP RPC
HTTPS (SSL/TLS)
Root, Namespace, or Database auth
Record Access
JWT Token, including SurrealDB Cloud
SSH Tunnel
Cloudflare Tunnel
SOCKS5 Proxy

Default port

8000

How to

Connect to SurrealDB in four steps.

1
Install TablePro and the SurrealDB plugin
brew install --cask tablepro. Open Settings > Plugins > Browse and install SurrealDB Driver.
2
Open New Connection
Click New Connection. Pick SurrealDB from the chooser sheet.
3
Fill in host, port, and auth level
Host localhost, port 8000, then pick Root, Namespace, Database, Record Access, or Token. Set Namespace for every level except Root and Token. Use the SSL/TLS pane to connect over HTTPS.
4
Connect
Click Connect. Namespaces appear in the sidebar, databases nest inside them, tables inside a database. Leave Database empty to pick one after connecting.

FAQ

Common SurrealDB questions.

Does it work with SurrealDB 1.x?

No. TablePro supports SurrealDB 2.x and 3.x over the HTTP RPC protocol. 1.x is not supported.

Which auth level should I pick?

SurrealDB cannot infer which level your credentials belong to. Root for a DEFINE USER ON ROOT user, Namespace or Database for users scoped to those, Record Access for a DEFINE ACCESS TYPE RECORD user, Token for a JWT. Only a root user can list every namespace.

Is TablePro free for SurrealDB?

Yes. AGPLv3 open source. The SurrealDB driver is a registry plugin, so picking SurrealDB in the chooser prompts to install it, and connecting to a saved SurrealDB connection installs it without asking.

Can I run multi-statement transactions?

Each HTTP request is independent, so BEGIN in one request cannot affect another. Run BEGIN TRANSACTION; ... COMMIT TRANSACTION; as a single query in the editor. Live queries with LIVE SELECT are not supported.

Can I create fields and indexes from the UI?

No. The structure editor is read-only for SurrealDB. Use DEFINE FIELD and DEFINE INDEX in the query editor instead.

Try TablePro for free.

Free and open-source. macOS 14+. Apple Silicon and Intel.

Download for Mac Setup guide