Settings

Settings is one dialog holding everything you can configure, grouped into APP, DATA, and FEATURES. Open it from the gear at the bottom of the rail, with Cmd+Shift+Comma, or from the command palette. Changes apply as you make them and there is no save button.

The version you are running is stamped at the bottom of the section list. Panes that need a plan you do not have keep their place in the list and show a lock, so nothing disappears from view.

APP

General

Appearance, the editor, and app behavior.

• Theme is three preview cards, Light, Dark, and System. The app repaints without a reload.
• Language follows your operating system by default and can be set to English or 日本語.
• Font family sets the font for every code editor, which covers scripting, PartiQL, and JSON. Leave it blank for the default monospace font.
• Editor theme (light mode) and Editor theme (dark mode) are searchable pickers with a live preview, one for each app appearance.
• Restore Tabs on Restart reopens the tabs you had open when the app starts.
• Group Single Tabs shows the workspace group indicator and bracket even when only one tab is open in that workspace.
• Group by Workspace Only When Multiple Open hides workspace brackets until a second workspace has tabs.
• When opening a table that’s already open chooses between Ask each time, Focus existing tab, and Always open a new tab.

Keyboard Shortcuts

The full hotkey editor. Every row can take a new binding through Add keyboard shortcut or drop one through Remove shortcut, conflicts are detected as you capture, and Reset All returns every binding to its default.

Tip: The capture dialog swallows keystrokes while it is open, so close it before you use a shortcut elsewhere in the app.

Onboarding

Everything to do with first-run guidance.

• Explore sample mode starts a local sample database so you can try the app without AWS.
• Enable page tours shows the per-page tour checklist on your own data. Sample mode always shows it.
• Reset progress clears per-page tour completion and un-hides dismissed page tours.
• Reset tours replays the in-app feature walkthroughs the next time you reach their screens.
• Reset clears every completed onboarding item, restores dismissed panels, and disconnects the active profile so the empty state reappears. Saved profiles, auth sessions, queries, and history are not touched.
• Dismissed panels restores the Setup panel or the Tips panel if you dismissed one permanently.

DATA

AWS

Connection defaults for the whole app.

• Default Profile is the AWS profile used when the app starts.
• AWS Regions is a multi-select of the regions offered for table browsing. It accepts a typed region as well as the listed ones.
• Max Connections caps the sockets the HTTP agent uses.
• Proxy URL routes AWS requests through an HTTP proxy.

Tables

The genuinely global table defaults. Each one notes that a workspace or table override wins over it.

• Page Size (Limit) sets the items per scan or query page.
• Stream Batch Size sets the items fetched per stream batch.
• Auto-Scan on Open scans a table the first time you open it. Tables with a vector index stay off unless a table override turns it on.
• Lock Key Editing prevents edits to partition and sort key values, including index keys, on existing items.
• Show Raw Table Names renders the raw AWS name everywhere, for every profile, and overrides per-profile and cleanup settings.

Workspace

One home for everything configured per workspace, with a workspace picker at the top that the rest of the pane follows.

• Identity holds the Alias shown across the app and the workspace Color, from a palette or a custom hex value. Clear the alias to go back to the derived profile and region name. Both round-trip with the status bar workspace row.
• Table Settings overrides page size, stream batch size, auto-scan, and lock key editing for this workspace. An unset value inherits the global default, a per-table override still wins, and a value equal to the one it inherits collapses back to inherit. For a table the classification engine has placed in an environment, environment defaults take precedence. Changes apply the next time you open a table and leave open tabs alone.
• Filtering hides tables whose name does not start with one of the prefixes you list.
• Table Name Cleanup holds the per-profile show-raw bypass and the prefix and suffix cleanup rules for this workspace’s profile and region. It needs a Pro plan, and the bypass is inert with a stated reason while the global raw-names switch is on.
• Remove workspace & data permanently deletes the workspace with its saved queries, scripts, table settings, history, favorites, variable environments, and tab groups. Removing a workspace from the connections popover keeps that data. This does not.

FEATURES

Environment

Environment classification and its rules, on Pro plans. Auto-Classification turns the engine on or off, Classification Rules holds your glob rules with a live impact preview, and Re-classify All runs the engine again. Below them, Environment defaults gives Production, Staging, and Development one row each with four table-setting pills. Environment classification covers all of it in detail.

AI

Two capabilities configured independently, each with its own provider, model, and Test connection. The pane is gated with Data Model, and either capability can be Off, which is the default and keeps the features that depend on it out of sight.

Completions powers Data Model enrichment and sends table structure only, never item data. Its providers are a detected Claude Code or Codex CLI, the Anthropic API, the OpenAI API, Amazon Bedrock, a custom OpenAI-compatible base URL, Local (uzu) on Apple Silicon Macs, and Local (localhost) for Ollama or LM Studio.

Embeddings generates the vectors that power search. It sends the item text you choose to embed and never runs without a confirmation. Only the embedding-capable providers are offered, meaning the OpenAI API, Amazon Bedrock, a custom base URL, and Local (localhost). The provider you pick here is the default for new embedding recipes, which can each choose any configured provider. Its Test connection embeds a fixed string and reports the dimension count a vector index would be created against.

Connection credentials are entered once per provider kind and shared by both sections, so a key saved under one shows as Key stored in the other. Model choice stays per capability. Keys are held in the OS keychain and never displayed back, so the pane offers Save and Remove rather than a readable field.

Amazon Bedrock uses an AWS profile instead of an API key. Pick the profile and the invocation region, and the model field becomes a searchable picker built from your own account’s Bedrock catalog. Local (uzu) downloads a small model and runs it on your Mac, so schema data never leaves the machine.

Note: Two more panes, Table Groups and Experimental, exist in the app but are hidden by build flags in the current release.