This page describes Calíope 1.5, the version I am building right now. 1.4 is on the App Store for the Mac, iPad, iPhone, Apple Watch, Apple TV and Apple Vision Pro. The changelog says which version each feature landed in.

Adds an “Open in Calíope” button to every topic. It only works with the app installed.

Snippets

Snippet Manager

Save and reuse frequently used SQL snippets.

Where it is: Workspace › Tools › Snippets

Open Snippets from the Tools sidebar. The list on the left shows each snippet with its category, the engines it is meant for and the start of its SQL; click one to edit it on the right.

The first time you open it connected to a server, Calíope adds sample snippets for that engine. Only show snippets compatible with the active server hides the ones written for other engines, and the search field looks in titles and content. The circular arrow in the top bar adds the samples back without touching yours, and the counter next to it says how many you have.

Every SQL Editor inserts them with its Snippets button, and with iCloud sync turned on they travel to your other devices.

Keywords: snippets, templates, code, reuse, fragments

Creating a Snippet

Add a new code snippet to your collection.

Where it is: Snippets › + Button (new snippet)

Click + in the Snippets top bar. The new snippet form opens on the right: enter a title, choose a Category and the Engines it works with (the active server's, unless you change them), write the SQL under Content and click Add. The new snippet is selected and ready to use.

Keywords: new snippet, add, create, save snippet

Editing and Saving a Snippet

Modify the title or content of an existing snippet.

Where it is: Snippets › Save / Copy

Select the snippet in the list. Change its title in the field at the top of the right panel, its Category and Engines in the menus below it, or its SQL in the editor. As soon as something changes, the blue Save button appears: click it to keep the change. Copy puts the SQL on the clipboard without leaving the panel.

Keywords: edit snippet, save, modify, copy

Deleting a Snippet

Remove a code snippet from the collection.

Where it is: Snippets › Trash Button

There are three ways to delete a snippet, and all three ask for confirmation first:

- Select it and click the trash button in the Snippets top bar.
- Right-click it in the list (long-press on iPad) and choose Delete.
- On iPad, swipe it left and tap Delete.

Deletion is permanent: there is no trash to recover it from. The sample snippets can come back with the circular arrow in the top bar.

Keywords: delete snippet, remove snippet, trash, delete, erase snippet