Examples
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.
Finding
Section titled “Finding”“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.
Saving and tidying
Section titled “Saving and tidying”“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.
Removing and bringing back
Section titled “Removing and bringing back”“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.
What it cannot do
Section titled “What it cannot do”- 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.