Skip to content

Examples

Markdown

A connected assistant sees your library as its tools show it: titles, addresses, sites, notes, tags, rooms, properties and the reader’s readings. These requests work well, and each names the tools the assistant would use. The Tools reference has the details.

“Where’s that bus ticket to Riga I saved?” copilka_search for Riga, then copilka_get_item with the reading, whose facts give the route, date and seat. Every word of a search has to appear, so a few distinctive words find more than a sentence does.

“Which job applications are still waiting to hear back?” copilka_list_fields to learn that the property is called Stage and what its choices are, then copilka_search with stage:applied.

“Has anything I’m watching got cheaper?” copilka_what_moved for prices going down.

“What did I save this week?” copilka_recent, from the cursor it kept last time, or without one for the latest changes.

“Save these three articles into Reading and tag them swiftui.” copilka_list_rooms and copilka_list_tags first, then copilka_save with the room and the tag, which is stored as SwiftUI. The titles appear once your Mac has read the pages.

“Make a Japan trip room inside Travel and save this hotel there.” copilka_create_room with Travel as the parent, then copilka_save into it. Saving into a room that does not exist makes it at the top, so the assistant makes the nested room first.

“Write down my packing list in the Japan trip room.” copilka_write_note, in Markdown, with its first line as its name.

“Keep these flights as a table.” copilka_save_table with a header row and a row per flight.

“Mark the three Berlin applications as Applied.” copilka_search, then copilka_set_properties with {"Stage": "Applied"}. With suggest, the values wait on your Mac for you to confirm.

“Fold my ‘mac os’ tag into macOS, and put Plants under Nature.” copilka_rename_tag from mac os to macOS, which merges the two, then copilka_set_tag_parent.

“From now on, put YouTube links in Watch later, and sort what’s in Unsorted.” copilka_set_rules adding a rule, site:youtube.com to Watch later, with then_sort_unsorted.

“Read this page again; the price is the one under Buy now.” copilka_read_item with that instruction. Your Mac does the reading, and copilka_get_item shows it once it lands.

“Clear out the old job listings in Jobs.” copilka_search in Jobs, then copilka_trash. With four or more items the server first returns what would go, and the assistant has to show you and confirm. This needs the Move to trash permission.

“I deleted a recipe yesterday by mistake. Get it back.” copilka_list_trash, then copilka_restore. Anything deleted in the last thirty days, on any device or by an assistant, can come back.

  • Delete anything for good, or empty the trash.
  • Delete a room.
  • Open files or pictures, or see what is in them.
  • Fetch a page itself: it asks your Mac, which reads when it is open.
  • Read pages as you, or touch your sessions.
  • Change your settings, apart from the sorting rules and the board’s layout.
  • Restrict itself to some rooms: a connection sees the whole library.