# Copilka

> Copilka, called Keepin until November 2026, is a Mac and iPhone app for the things you want to keep: links, receipts, tickets, books, code, notes. Save something and Copilka reads it, works out what it is, and files the facts; find it later on either device. Your library is plain JSON on your own disk, encrypted at rest when it syncs. Assistants can be connected through MCP to search, save and tidy the library.

Every page of this documentation is served as Markdown: replace the trailing slash of a page's address with `.md`, or request the page with `Accept: text/markdown`. The whole documentation is in one file at https://docs.copilka.app/llms-full.txt. The pages were written from the apps' source and quote the apps' own words for controls, settings and messages.

To read or change what a user has saved in Copilka, rather than read about Copilka, connect to Copilka's own MCP server at https://mcp.copilka.app/mcp; the Assistants section explains how.

## Start here

- [What Copilka is](https://docs.copilka.app/start/what-copilka-is.md): A short orientation, the words the rest of these docs use, and how the pieces fit together.
- [Install on your Mac](https://docs.copilka.app/start/install-on-your-mac.md): What Copilka needs, how it is installed and updated, and which permissions macOS will ask about.
- [Sign in](https://docs.copilka.app/start/sign-in.md): The three ways in, what the invitation means, the two-Macs-and-an-iPhone rule, and signing out.
- [Your first saves](https://docs.copilka.app/start/first-saves.md): A tour of the window and the first ten minutes with Copilka.

## Saving

- [Ways to save](https://docs.copilka.app/saving.md): Every way something gets into the library, and where it lands.
- [Links, notes and files](https://docs.copilka.app/saving/links-notes-files.md): What Copilka does with each kind of thing you save, and the difference between referencing a file and copying it.
- [Paste and drag and drop](https://docs.copilka.app/saving/paste-and-drop.md): How the clipboard is read when you paste to save, and what happens when you drop things on the window.
- [Quick capture](https://docs.copilka.app/saving/quick-capture.md): One hotkey, anywhere on your Mac, and a small panel that saves whatever lands in it.

## Reading

- [How a link reads itself](https://docs.copilka.app/reading/how-a-link-reads-itself.md): What happens between saving a link and seeing it become a book, a ticket or a product, and how to steer it.
- [Kinds of things](https://docs.copilka.app/reading/kinds.md): Every kind of thing the reader recognises, the facts it keeps for each, and the sites it understands directly.
- [Pictures and files](https://docs.copilka.app/reading/pictures.md): What Copilka does with a photograph of a receipt, a screenshot, a boarding pass or a file, and how it offers to file it as the thing it shows.
- [Read as you](https://docs.copilka.app/reading/read-as-you.md): Reading pages that need your login, with your own sessions, on your Mac.

## Organising

- [Rooms](https://docs.copilka.app/organising/rooms.md): Where things live, how rooms nest, and what a room can carry.
- [Tags](https://docs.copilka.app/organising/tags.md): The tags the reader gives things, the ones you add, how they nest, and how names are kept tidy.
- [Smart views and the sidebar](https://docs.copilka.app/organising/smart-views.md): Everything, Favorites, Unsorted and the kinds, plus arranging the sidebar and choosing what Copilka opens on.

## Finding

- [Search](https://docs.copilka.app/finding/search.md): What the search field matches, and the field:value tokens that search properties.
- [The board](https://docs.copilka.app/finding/board.md): Layouts, sizes, sorting and grouping, arranging cards by hand, selecting several, and the keys that work on the board.

## Items

- [Cards](https://docs.copilka.app/items/cards.md): How each kind of thing is drawn on the board, and what the badges on a card mean.
- [The details panel](https://docs.copilka.app/items/details-panel.md): Everything Copilka knows about one item, the actions on it, editing it, covers, and looking at pictures.
- [Properties](https://docs.copilka.app/items/properties.md): The facts on an item, the ones the reader fills in, the ones you add yourself, and the rules that move a status on their own.
- [Compare](https://docs.copilka.app/items/compare.md): Two or more things side by side, showing only what differs.
- [Prices and changes](https://docs.copilka.app/items/prices-and-changes.md): How Copilka watches a price, a version or a state after you save it, and what it shows when one moves.
- [Alternatives](https://docs.copilka.app/items/alternatives.md): Finding the same product, or a similar one, at other shops in the same country.
- [Delete, undo and missing files](https://docs.copilka.app/items/delete-undo-missing.md): What deleting does and does not do, how far undo reaches, and what happens when a referenced file moves.

## Sync and devices

- [How sync works](https://docs.copilka.app/sync/how-sync-works.md): What syncs, when, how two devices' changes are reconciled, and what the status words mean.
- [Devices](https://docs.copilka.app/sync/devices.md): The two-Macs-and-one-iPhone rule, replacing a device, removing one, and how sessions stay valid.
- [Files and pictures across devices](https://docs.copilka.app/sync/files-and-pictures.md): Which files are uploaded, how they appear on another device, and the limits.

## Keepin on iPhone

- [Copilka on iPhone](https://docs.copilka.app/iphone.md): The iPhone app, what it needs, how you sign in, and how it differs from the Mac.
- [Saving on iPhone](https://docs.copilka.app/iphone/saving.md): The save menu, the camera, the scanner, pasting, and sharing into Copilka from other apps.
- [The item screen](https://docs.copilka.app/iphone/item-screen.md): What an item shows on the phone, what you can edit there, and the menus behind a long press.
- [Sync on iPhone](https://docs.copilka.app/iphone/sync.md): When the phone syncs, what arrives from the Mac, what the banner means, and working offline.
- [Settings on iPhone](https://docs.copilka.app/iphone/settings.md): Every settings page on the phone and what each switch does.

## Assistants

- [Connect Claude](https://docs.copilka.app/assistants/connect-claude.md): Let Claude search, save and tidy your library through Copilka's MCP server, and take it back any time.
- [Other clients](https://docs.copilka.app/assistants/other-clients.md): What any MCP client needs to connect to Copilka, and what will not work.
- [Examples](https://docs.copilka.app/assistants/examples.md): What to ask a connected assistant, what it does behind the scenes, and what it cannot do.
- [Tools reference](https://docs.copilka.app/assistants/tools.md): Every tool Copilka's MCP server offers an assistant, with its parameters, limits, what it returns and what it may not do.
- [Permissions and safety](https://docs.copilka.app/assistants/permissions-and-safety.md): What a connected assistant can reach, the three permissions, rate limits, the audit, and how page text is kept from steering it.

## Account and privacy

- [Plans and invites](https://docs.copilka.app/account/plans.md): What an invitation gives you, what the subscription unlocks, and the allowances behind the reader.
- [What leaves your device](https://docs.copilka.app/account/privacy.md): Exactly what Copilka sends where, which models read your pages, and what the service keeps.
- [Encryption and the cloud](https://docs.copilka.app/account/encryption.md): How what you sync is stored on Copilka's service, who can read it, and where it is.
- [Your data on disk](https://docs.copilka.app/account/your-data-on-disk.md): Where the library lives on your Mac, what the files are, and how to take a copy.
- [Delete your account](https://docs.copilka.app/account/delete-account.md): The difference between signing out and deleting, and what deleting does.

## Reference

- [Keyboard shortcuts](https://docs.copilka.app/reference/keyboard-shortcuts.md): Every key Copilka answers to, and how to change the ones that can be changed.
- [Menus](https://docs.copilka.app/reference/menus.md): The menu bar, item by item.
- [Settings](https://docs.copilka.app/reference/settings.md): Every page of Settings on the Mac, every option, and what each defaults to.
- [Updates and versions](https://docs.copilka.app/reference/updates-and-versions.md): How Copilka updates itself, and the versions so far.
- [Troubleshooting](https://docs.copilka.app/reference/troubleshooting.md): What to do when something does not work, by symptom.
- [Questions and answers](https://docs.copilka.app/reference/faq.md): Short answers to the questions that come up first.
- [For AI agents](https://docs.copilka.app/reference/for-agents.md): How an assistant, a crawler or a script reads this documentation as plain Markdown, with llms.txt, one Markdown file per page, and content negotiation.

## Optional

- [Everything in one file](https://docs.copilka.app/llms-full.txt)
- [Sitemap](https://docs.copilka.app/sitemap-index.xml)
- [The Copilka site](https://copilka.app)
