# Examples

What to ask a connected assistant, what it does behind the scenes, and what it cannot do.

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](https://docs.copilka.app/assistants/tools/) has the details.

## 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

**"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

**"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

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

---

This page: https://docs.copilka.app/assistants/examples/ · As Markdown: https://docs.copilka.app/assistants/examples.md · Every page: https://docs.copilka.app/llms.txt
