COLIBRI SQL — User manual

Version 1.4 · A LiVnet product - RELV - 2026

COLIBRI SQL is a lightweight SQL Server client, in the style of SSMS, for Linux (including ARM devices such as the Surface RT) and Windows. It connects to one or more servers, writes and runs queries, explores the objects of each database, works with scripts versioned in git and offers tools to compare, clone, back up or schedule tasks.

1. Getting started

Installation

Language

The program is in Spanish, English and Portuguese. Choose it in ☰ → Language (or «Automatic», the system one); it is saved and applied the next time the program opens. On Windows the installer also asks for the language.

License and free trial

The window

2. Connecting to a server

When the program opens (or with the Connect button, or Ctrl+Shift+N) the Connect tab appears: your saved profiles on the left (the last one used on top) and the form on the right. Double-click or Enter on a profile connects. While it connects you can keep using the program, and the Connect button becomes Cancel connection (if you got the server or the details wrong, no need to wait): fix them and connect again. If you choose another profile (double-click) or press Enter while it connects, the attempt is cancelled and it connects with the new details.

Profile data

The status box shows each step (tunnel, server, user) and errors with a hint of the cause. Everything is kept in the Connection log (button on the top bar).

Open connections

In the explorer, right-click a server: Edit connection…, Server monitor…, SQL Server Agent jobs…, Restore a database…, Connection color and Disconnect. When disconnecting, that server's tabs are not closed: they stay without connection, with their text.

3. Query tabs

Many tabs

Three helpers, turned on in ☰ → Tabs:

Close: with the ×, with the middle mouse button or with a right-click on a tab: close, close others, those to the left, those to the right, all, those of this connection or those without changes. If several have unsaved changes, it asks only once. If the tab is saved to a file, the same menu has Show in the Project panel (if the file belongs to the folder open in «Project»: it opens the panel and its folders and selects it) and Show in file manager (the file is selected on Windows and on Linux with Thunar, Nautilus, Nemo or Dolphin; PCManFM only opens the folder).

4. The editor and running queries

The query bar

All buttons are icons; hovering shows their name and shortcut, and the ? button (or F1) explains each one.

ButtonShortcutWhat it does
RunF5 · Ctrl+ERuns the whole script, or the selection
Statement at cursorF8 · Ctrl+EnterRuns only the statement where the cursor is
CancelEscStops the execution
PlanCtrl+LEstimated execution plan, without running
DebugAlt+F5 · F10Runs step by step, with breakpoints (F9)
ClearClears the editor (undo with Ctrl+Z)
OutlineCtrl+Shift+OBatches, statements and CTEs of the script
AssistantCtrl+IAI assistant panel
DatabaseActive database of the tab (USE)
PadlockOpen = Auto; closed = Manual (Commit / Rollback)

Transactions

Writing helpers

5. Results

Each SELECT gives a result in its own tab (or one below the other, with the Stacked results button). Messages (PRINT) and errors go to Messages, in the order they arrive, as in SSMS: each error shows its number, level, state and, if it comes from a procedure, which one and its line; if it is from the script itself, the editor line. At the end, the completion time (also when there were errors). If there was an error, Messages opens, but the rows that arrived stay in their tab. Note: if the script did a ROLLBACK afterwards, those rows are no longer in the database.

6. Object explorer

7. AI assistant

Assistant button (Ctrl+I). It writes, explains and fixes queries knowing your database structure and the tab's connection. Answers with SQL have the Insert ▾ button: at the cursor, at the end of the editor, or clear the editor and insert; a short comment with the model and the date is added before the SQL. Everything can be undone with Ctrl+Z.

Privacy: with cloud models the assistant does not read table data unless you enable it in its settings; with a local model it always can.

8. Project (scripts with git)

Project tab of the side panel: open a folder of scripts (if it is a git repository, it shows the branch and its state).

9. Tools

10. Settings and files

11. Keyboard shortcuts

ShortcutAction
F5 · Ctrl+ERun all or the selection
F8 · Ctrl+EnterRun the statement at the cursor
Ctrl+LExecution plan
EscCancel the execution
Ctrl+N · Ctrl+Shift+NNew query · Connect
Ctrl+O · Ctrl+S · Ctrl+Shift+SOpen · Save · Save as
Ctrl+WClose the tab
Ctrl+Page Up · Ctrl+Page DownPrevious · next tab
Ctrl+Shift+AList of all tabs
Ctrl+BShow or hide the side panel
Ctrl+RShow or hide the results
Ctrl+IAI assistant
Ctrl+Space · TabAutocomplete · expand * or snippet
Ctrl+/Comment or uncomment lines
Ctrl+KFormat SQL
Shift+Alt+arrowsColumn editing (also Shift+Alt+drag)
Ctrl+Z · Ctrl+YUndo · redo (also Ctrl+Shift+Z)
Ctrl+F · F3Find · next
Ctrl+G · Ctrl+PGo to line · Go to object
F12 · Alt+F7 · Ctrl+QDefinition · Where used · Quick documentation
Ctrl+HQuery history
Ctrl+Shift+F · Ctrl+Shift+ESearch in database · Compare in several databases
Ctrl+Shift+OScript outline
F9 · F10 · Shift+F5Breakpoint · step · stop debugging
F1What each bar button does

12. Troubleshooting