# What do you want to do?

Pick a task, or type a few words. Every answer is written from the app itself: its menus, its buttons, its words.

*Written from Teserra 1.3.16.*

## Start

- [Install Teserra and create a library](https://teserra.app/docs/first-launch)
- [Bring in the images already on my Mac](https://teserra.app/docs/first-launch#found)
- [Look around with a demo library first](https://teserra.app/docs/first-launch#found)
- [Open my library from another Mac](https://teserra.app/docs/first-launch#already)

## Bring things in

- [Import a folder of images](https://teserra.app/docs/adding-things#import)
- [Move my Eagle library over](https://teserra.app/docs/switch-from-eagle)
- [Capture a screenshot from any app](https://teserra.app/docs/adding-things#capture-m)
- [Save an image or a video from a web page](https://teserra.app/docs/chrome-extension#quick-save-option-click-anything)
- [Save a web page as a link or an article](https://teserra.app/docs/chrome-extension#the-popup-save-as-image-link-or-article)
- [Add my installed fonts as specimens](https://teserra.app/docs/adding-things#import)

## Organize

- [Tag fifty images at once](https://teserra.app/docs/organize#several-items-at-once)
- [Put images in a collection](https://teserra.app/docs/organize#collections)
- [Make a contact sheet to send](https://teserra.app/docs/organize#contact-sheet)
- [Rate images from the keyboard](https://teserra.app/docs/shortcuts#find-and-file)

## Find

- [Find an image by describing it](https://teserra.app/docs/search#k-one-search-box)
- [Find images that look alike](https://teserra.app/docs/search#find-similar)
- [See what goes with a few images](https://teserra.app/docs/search#constellation)
- [Filter by colour, date or rating](https://teserra.app/docs/search#filters)

## With your AI

- [Connect Claude Code, Cursor or Raycast](https://teserra.app/docs/agents#turn-it-on)
- [Write the taste of a collection](https://teserra.app/docs/agents#ready-made-commands)
- [Let my agent describe untitled images](https://teserra.app/docs/agents#ready-made-commands)
- [Choose what an agent may change](https://teserra.app/docs/agents#what-agents-can-change-if-you-let-them)
- [Find ideas of what to ask my agent](https://teserra.app/docs/prompts)
- [Title and tag images with my own AI key](https://teserra.app/docs/curator#set-it-up)
- [Know what is sent to the AI provider](https://teserra.app/docs/curator#what-is-sent-and-what-is-not)

## Sync and files

- [Sync with my NAS or my own server](https://teserra.app/docs/sync#connect-your-server)
- [Open the same library on a second Mac](https://teserra.app/docs/sync#another-mac)
- [Reach the library away from home](https://teserra.app/docs/sync#away)
- [See what Teserra writes on disk](https://teserra.app/docs/vault-format#the-folder)
- [Rebuild the library from its files](https://teserra.app/docs/vault-format#the-database-is-a-cache)

## Fix something

- [The browser extension can’t reach Teserra](https://teserra.app/docs/troubleshooting#extension)
- [⌘⇧M does nothing](https://teserra.app/docs/troubleshooting#capture)
- [Search by meaning finds nothing](https://teserra.app/docs/troubleshooting#search)
- [My AI client doesn’t see Teserra](https://teserra.app/docs/troubleshooting#agent)
- [The Curator writes nothing](https://teserra.app/docs/troubleshooting#curator)

## License

- [Buy a license](https://teserra.app/docs/license#buying)
- [Free a Mac to activate another one](https://teserra.app/docs/license#three-macs)
- [Get my license key again](https://teserra.app/docs/license#lost-your-key)
- [Ask for a refund](https://teserra.app/docs/license#refunds)

## Your setup

Tick what is done; this page remembers it on this browser.

1. Download Teserra and tell it what you keep [Your first launch](https://teserra.app/docs/first-launch)
2. Bring in what is on your Mac: screenshots, your Eagle library, a folder [Your images are already somewhere](https://teserra.app/docs/first-launch#found)
3. Let search get ready, 290 MB, once [Search](https://teserra.app/docs/first-launch#search-model)
4. Connect your browser [Browser extension](https://teserra.app/docs/chrome-extension#connect)
5. Capture something with `⌘⇧M` [Capture](https://teserra.app/docs/adding-things#capture-m)
6. Open your library to your AI client [Agent access](https://teserra.app/docs/agents#turn-it-on)
7. Write the taste of your best collection [Your taste](https://teserra.app/docs/prompts#your-taste)
8. Optional: keep your Macs in sync [Sync](https://teserra.app/docs/sync)

> **Requirements.** A Mac with Apple Silicon running macOS 12 or later. About 400 MB for the app and the local search model. No account.

## Words we use

| Word | Meaning |
| --- | --- |
| Vault | A library. A folder on your disk with your originals, small text notes next to them, and a cache. You can have several. |
| Collection | A group of items, nested as deep as you like. An item can live in several collections. |
| Curator | The AI that titles, describes and tags your items, on your own key. |
| Sidecar | The small `.teserra` text file next to each original that holds what you decided about it. |
| Add-on | A module you can switch off: Links, Articles, Visual search, Curator, Agent access. |