This page describes Calíope 1.7, the version I am building right now. 1.6 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 the queries and commands you use most.

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 content; 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.

Redis

A Redis session has no SQL Editor: Open in console, in the header of the selected snippet, leaves it written in the console without running it, and when you press Return the console refuses it or asks for confirmation exactly as if you had typed it yourself.

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 query or command 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 content in the editor. As soon as something changes, the blue Save button appears: click it to keep the change. Copy puts the content on the clipboard without leaving the panel. If you pick another snippet without saving, the change is discarded.

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 a touch screen) and choose Delete.
- On a touch screen, 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.

Apple Vision Pro: look at the snippet and pinch and hold to open its menu, or swipe it left by pinching and moving.

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