# Príkazový riadok exporter

Spúšťajte svoje exporty z Terminálu, cronu, zálohovacích nástrojov a agentov.

`exporter` je aplikácia Exporter pre Mac spustená bez okna. Používa rovnaké pripojenia, priečinky exportu, výber a nastavenia, aké ste si nastavili v aplikácii, a zapisuje do rovnakého záznamu exportu. Funguje aj pri zatvorenej aplikácii a nikdy sa na nič nepýta: čokoľvek chýba, zastaví beh s návratovým kódom 2 a jedným riadkom, ktorý povie, čo urobiť. Iba pre macOS.

## Inštalácia

1. Nainštalujte Exporter z Mac App Store ([stiahnuť](https://exporter.dev/download)) a otvorte ho.
2. Pripojte aplikáciu (Poznámky, Bear, Logseq, Kontakty, Správy alebo Čas pred obrazovkou) alebo priečinok Dokumentov a zvoľte jej priečinok exportu ([začíname](https://exporter.dev/docs/getting-started)). Tieto povolenia sa dajú udeliť iba v aplikácii.
3. Na karte Command Line v aplikácii stlačte "Copy Install Command" a raz ho vložte do Terminálu.

Aplikácia beží v sandboxe a nemôže zapisovať do vašej premennej PATH, preto je posledný krok vloženie. Riadok nainštaluje `exporter` do `/opt/homebrew/bin`, ak tento priečinok existuje a patrí vám (bez sudo), inak do `/usr/local/bin` so sudo. Opakované vloženie je bezpečné; nahradí, čo tam bolo. Riadok nainštaluje aj `notes-exporter`, starý názov príkazu, takže staršie skripty a riadky cronu fungujú ďalej. `exporter help install` vypíše riadok pre váš Mac.

## Zdroje

`--source` prijíma jednu z týchto hodnôt:

| zdroj | prijíma aj | zapisuje |
| --- | --- | --- |
| `apple` | `apple-notes`, `applenotes`, `notes` | markdown alebo html |
| `bear` | | markdown alebo html |
| `logseq` | | vždy markdown |
| `contacts` | `apple-contacts`, `addressbook` | vždy markdown |
| `messages` | `imessage`, `chats`, `conversations` | vždy markdown |
| `screentime` | `screen-time`, `usage` | vždy markdown, jeden súbor na deň |
| `reminders` | `apple-reminders`, `lists`, `todos` | vždy markdown, jeden súbor na zoznam |
| `claude-code` | `claudecode`, `claude`, `claude-code-sessions` | markdown, pôvodný záznam alebo oboje, podľa zaškrtnutia na karte |
| `wallet` | `passes`, `pkpass`, `boarding-passes`, `tickets` | vždy markdown, jeden súbor na kartu |
| `documents` | `docs`, `files`, `pdf` | formáty zaškrtnuté na karte Dokumentov |

## Formáty

`--format` prijíma `markdown` (alebo `md`) alebo `html`; na veľkosti písmen nezáleží. Čokoľvek iné skončí hlásením `error: --format pdf: expected markdown | html` a návratovým kódom 64.

- bez neho `sync` zapisuje každú aplikáciu vo formáte nastavenom na jej karte (Poznámky a Bear majú každý vlastný) a `export` zapisuje podľa nastavenia aplikácie, ktorú exportuje; `exporter help sync` a `exporter help export` ukazujú aktuálne nastavenia
- Logseq, Kontakty, Správy a Čas pred obrazovkou sú vždy markdown a Dokumenty zapisujú formáty zaškrtnuté na svojej karte, takže pri nich sa `--format html` ignoruje s poznámkou: `note: logseq export is always markdown, so --format is ignored for this source.`
- Poznámky zapisujú jednu stránku `.html` na poznámku ([formát HTML](https://exporter.dev/docs/notes#markdown-and-html)), prílohy skopírované do `attachments/` vedľa nej a prepojené odkazmi, bez front matter. HTML z Bearu je čistý text poznámky vnútri `<pre>`, bez štýlov, a odkazy na prílohy zostanú ako text Markdownu: súbory sa skopírujú, ale neodkazuje sa na ne
- server MCP číta iba súbory markdown, takže export iba v HTML pre neho nie je viditeľný
- Poznámky a Bear zapisujú v jednom behu jeden formát; oba v jednej synchronizácii zapisujú iba Dokumenty. Beh odstraňuje iba staré súbory svojho vlastného formátu, takže po prepnutí zostanú v priečinku súbory druhého formátu. Pre oba formáty dajte každému vlastný priečinok:

```sh
exporter export --dest ~/Backups/notes-md   --format markdown
exporter export --dest ~/Backups/notes-html --format html
```

## sync

Spustí export nastavený v aplikácii, raz, prírastkovo, do priečinkov exportu aplikácie.

```sh
exporter sync [--source <source>]... [--format markdown|html] [--full] [--json] [--quiet]
```

| prepínač | čo robí | predvolené |
| --- | --- | --- |
| `--source <source>` | iba táto aplikácia, dá sa opakovať | všetky pripojené aplikácie; nepripojené sa preskočia |
| `--format markdown\|html` | iba pre tento beh, nastavenie aplikácie sa nemení. Uloží sa do rovnakého priečinka exportu ako druhý formát; ak chcete mať oba, exportujte každý do vlastného priečinka pomocou `export --dest` | vaše nastavenie v aplikácii |
| `--full` | exportuje všetko znova. Pred zápisom odstráni iba súbory, ktoré zapísal Exporter; všetko ostatné v priečinku exportu zostane | vypnuté |
| `--json` | strojovo čitateľný súhrn | vypnuté |
| `--quiet`, `-q` | iba chyby | vypnuté |

```sh
exporter sync --source apple
```

```text
apple notes: exporting…
apple notes: 1204 of 1204 exported · 3 removed · 18.2s · markdown → /Users/me/Documents/notes
```

Súhrnný riadok má tvar `<source>: <succeeded> of <selected> exported`, potom, ak nastanú, `N failed`, `N removed` (súbory položiek, ktoré boli zmazané, premenované alebo presunuté), `N attachment issues` a nakoniec trvanie, formát a zapísaný priečinok.

Ak aplikácia beží, `sync` nič neexportuje, skončí s kódom 0 a vypíše `Exporter is running: real-time sync is live, the export root is already current.`

## export

Jednorazový export do priečinka podľa vašej voľby, pre snímky a skripty. Funguje bez problémov aj pri otvorenej aplikácii.

```sh
exporter export --dest <folder> [--source <source>] [--format markdown|html] [--organize folders|tags|smart] [--folder "Name"]... [--tag name]... [--dry-run] [--json] [--quiet]
```

| prepínač | čo robí | predvolené |
| --- | --- | --- |
| `--dest <folder>` | povinný. Musí byť vnútri priečinka povoleného na karte Command Line v aplikácii ("add folder"). Povolenie pre `~/Backups` platí pre všetky priečinky pod ním | žiadne |
| `--source <source>` | aplikácia na export | `apple` |
| `--format markdown\|html` | formát pre tento beh | vaše nastavenie v aplikácii |
| `--organize folders\|tags\|smart` | iba Poznámky: ako sa poznámky rozložia do priečinkov, pre tento beh | "Organize" na karte |
| `--folder "Name"` | iba tento priečinok Poznámok, dá sa opakovať, názov sa porovnáva bez ohľadu na veľkosť písmen | výber uložený v aplikácii |
| `--tag name` | iba tento štítok, dá sa opakovať, Poznámky alebo Bear | výber uložený v aplikácii |
| `--dry-run` | vypíše, čo by sa exportovalo, nič nezapíše | vypnuté |
| `--json`, `--quiet` (`-q`) | ako pri sync | vypnuté |

Bez `--folder` alebo `--tag` exportujú Poznámky a Bear výber uložený v aplikácii. Logseq exportuje celý graf; Kontakty, Správy, Čas pred obrazovkou a Dokumenty exportujú to, čo majú zaškrtnuté na karte, rovnako ako `sync`; filtre sa pri nich ignorujú s poznámkou. Pri Dokumentoch `--dry-run` vypíše `would convert <n> document(s)` a beh uvedie súbory, ktoré nedokáže prečítať: `note: 3 file(s) skipped: not a format any engine converts.`

```sh
exporter export --dest ~/Backups/notes-$(date +%F)
exporter export --dest ~/Backups/work --folder "Work" --format html
exporter export --dest ~/Backups/bear --source bear --tag journal
exporter export --dest ~/Backups/people --source contacts
exporter export --dest ~/Backups/papers --source documents
exporter export --dest ~/Backups/notes --dry-run
```

```text
would export 100 apple notes · markdown → /Users/me/Backups/notes
```

## list

```sh
exporter list sources|folders|tags|dests [--source apple|bear] [--json]
```

| zoznam | čo ukazuje | JSON |
| --- | --- | --- |
| `sources` | každá aplikácia, pripojená aj nepripojená, s jej počtom. Dokumenty sa neuvádzajú | `[{"source": "apple", "connected": true, "notes": 1204}, {"source": "messages", "connected": true, "conversations": 1532}, {"source": "bear", "connected": false}]`, s `pages` pre logseq, `contacts` a `days` pre `screen-time` |
| `folders` | priečinky Poznámok s počtami poznámok, odsadené podľa hĺbky. `--source bear` je chyba (kód 64) | `[{"name": "Work", "notes": 42, "level": 0}]` |
| `tags` | štítky s počtami, predvolene z Poznámok, z Bearu s `--source bear` | `[{"name": "journal", "notes": 12}]` |
| `dests` | priečinky, do ktorých smie `export --dest` zapisovať, a k tomu priečinok exportu každej aplikácie | `[{"path": "/Users/me/Backups", "kind": "granted"}]`, kde `kind` je `granted`, `granted, volume not mounted` alebo `export root (apple-notes)` |

```sh
exporter list folders --json
```

```json
[{"name": "Work", "notes": 42, "level": 0}]
```

## status

```sh
exporter status [--json]
```

```text
apple notes    connected · last export 2026-09-11 03:00
bear           not connected
logseq         not connected
contacts       not connected
messages       connected · last export 2026-09-11 03:01
screen time    not connected
documents      not connected
root (apple-notes)  /Users/me/Documents/notes
root (messages)  /Users/me/Documents/messages
destinations   /Users/me/Backups
version        3.24 · free · 100 of 100 free notes used
messages       free · 50 of 50 free conversations used
organize       apple notes by folder · contacts in one folder
app            not running
```

S `--json`: jeden objekt na aplikáciu, pomenovaný `apple-notes`, `bear`, `logseq`, `contacts`, `messages`, `screen-time`, `documents`, každý `{"connected": true, "lastExport": "2026-09-11 03:00"}` (`null`, ak export nikdy neprebehol); `destinations` (cesty); `tier` (`full` alebo `free`, odomknutie Poznámok) a `freeNotesUsed`; `contactsTier` a `freeContactsUsed`; `messagesTier` a `freeConversationsUsed`; `screenTimeTier` a `freeDaysUsed`; `organize` (`{"appleNotes": "folders", "contacts": "flat"}`, "Organize" na kartách); `appRunning`. Časy sú miestne, `yyyy-MM-dd HH:mm`.

## log

Nedávne behy exportu, od najnovšieho: rovnaký záznam, aký ukazuje aplikácia, zo všetkých priečinkov exportu a povolených priečinkov `--dest`. Priečinky s dátumom vytvorené pod povoleným priečinkom sa nečítajú; ich záznam je v `<folder>/.exporter/`.

```sh
exporter log [--last N] [--json]
```

| prepínač | čo robí | predvolené |
| --- | --- | --- |
| `--last N` | koľko behov | 10 |
| `--json` | jeden objekt na beh | vypnuté |

```text
2026-09-11 03:00  apple-notes   1204/1204 exported  3 removed  clean  → /Users/me/Documents/notes
```

JSON: `[{"source", "finishedAt", "selected", "succeeded", "failed", "format", "status", "destination", "prunedFiles", "runError"}]`. `status` je `clean`, `warnings` (chýbajúce prílohy) alebo `failures`.

## doctor

Overí, že export bez okna bude fungovať, a pre každú kontrolu vypíše jeden riadok: `ok`, `FAIL` s riadkom `fix:` pod ním, `warn` alebo `--` pre informáciu.

```sh
exporter doctor
```

Kontroluje, že databáza každej pripojenej aplikácie je čitateľná a jej priečinok exportu zapisovateľný, že každé uložené povolenie k priečinku funguje, že každý priečinok `--dest` je zapisovateľný, index a nainštalovaný príkaz. Na konci uvedie úroveň verzie, či aplikácia beží, a posledný pád, ak nejaký bol. Kód 0 vypíše `all good.`, kód 2 vypíše `N problem(s) found.`

## report

Vypíše diagnostické hlásenie (verzia aplikácie, macOS a hardvér, stav pripojenia, nedávne behy, posledný pád; žiadny obsah poznámok) a skopíruje ho do schránky.

```sh
exporter report [--send] [--email <addr>]
```

| prepínač | čo robí | predvolené |
| --- | --- | --- |
| `--send` | odošle hlásenie nám a vypíše `sent.` alebo `offline: queued, will send on the next run or app launch.` | vypnuté |
| `--email <addr>` | pridá vašu adresu, aby sme mohli odpovedať | žiadna |

## help a version

- `exporter help [topic]`: témy `sync`, `export`, `list`, `status`, `log`, `doctor`, `report`, `cron`, `install`. Pomoc k príkazu ukazuje vaše aktuálne nastavenia ako predvolené hodnoty
- `sync`, `export`, `list`, `log` a `report` prijímajú aj `--help` alebo `-h`
- `exporter version` (alebo `--version`, `-v`) vypíše `exporter 3.24`
- samotný `exporter` v termináli vypíše prehľad a skončí s kódom 64

## Výstup JSON

`--json` funguje pri `sync`, `export`, `list`, `status` a `log`. Výstup je formátovaný so zoradenými kľúčmi. Pri `sync` a `export` pridajte `--quiet`: bez neho sa riadky priebehu a poznámok vypíšu na stdout pred JSON. `export` vypíše jeden súhrnný objekt, `sync` vypíše `{"runs": [...]}` s jedným objektom na zdroj:

```json
{
  "attachmentIssues" : 0,
  "durationSec" : 18.2,
  "failed" : 0,
  "format" : "markdown",
  "root" : "/Users/me/Documents/notes",
  "runError" : null,
  "selected" : 1204,
  "source" : "apple-notes",
  "status" : "clean",
  "succeeded" : 1204
}
```

Keď aplikácia beží, `sync` vypíše svoj jeden riadok a žiadny JSON. Chyby idú na stderr ako `error: <what happened and what to do>`.

## Návratové kódy

| kód | význam |
| --- | --- |
| 0 | v poriadku, vrátane behu, ktorý skrátil limit zadarmo |
| 1 | zlyhania exportu: položka zlyhala, beh narazil na chybu alebo vybral položky a žiadnu nezapísal |
| 2 | vyžaduje nastavenie: aplikácia nie je pripojená, priečinok nie je povolený, priečinok alebo štítok sa nenašiel, nie je čo exportovať; `doctor` našiel problémy; nainštalovaný príkaz má starý formát alebo aplikácia, na ktorú ukazuje, zmizla |
| 64 | použitie: neznámy príkaz alebo prepínač, chýbajúca alebo chybná hodnota, `--folder` s Bearom, `list folders --source bear`, samotný `exporter` v termináli |

## Kam sa súbory ukladajú

`sync` zapisuje do priečinka exportu nastaveného pre každú aplikáciu v Exporteri, napríklad `~/Documents/notes` alebo `~/Documents/messages`; `export` zapisuje do `--dest`. Priečinok na úrovni vášho domovského priečinka alebo o úroveň nižšie, napríklad samotný `~/Documents`, dostane podpriečinok pre každú aplikáciu (`notes-export`, `messages-export` a tak ďalej) a hlbší priečinok sa použije tak, ako je. Súhrnný riadok (za šípkou) a `root` v JSON ukazujú skutočný priečinok.

Každý priečinok exportu obsahuje `.exporter/last-export.json` a `.exporter/last-export.md` (posledný beh) a `.exporter/history/` (posledných 50 behov). Každá aplikácia uchováva aj `.exporter/files.json`, každý súbor, ktorý beh zapísal: ďalší beh odstráni iba súbory z tohto zoznamu, ktoré už žiadna položka nevytvára, takže poznámky, ktoré ste zmazali, premenovali alebo im zmenili štítky, prídu o svoj starý súbor (Čas pred obrazovkou súbor dňa nikdy neodstráni). Exporty z Poznámok a Logseq dostanú aj `bases/` so zobrazeniami pre Obsidian.

## Limit zadarmo

Príkazový riadok má rovnaké limity ako aplikácia:

| aplikácia | zadarmo |
| --- | --- |
| Poznámky | 100 poznámok |
| Kontakty | 100 kontaktov |
| Správy | 50 najnovších konverzácií |
| Čas pred obrazovkou | 10 najnovších dní pri prvej synchronizácii, a iba tie: neskoršie dni potrebujú odomknutie |
| Dokumenty | 10 naposledy upravených dokumentov |
| Bear a Logseq | bez limitu |

Už exportované položky sa ďalej synchronizujú zadarmo; limit zastaví iba nové. Beh, ktorý na limit narazí, aj tak exportuje, čo smie, skončí s kódom 0 a vypíše poznámku (nie pri `--quiet`):

```text
note: 42 note(s) skipped: free version limit (100 of 100 free notes). upgrade in the app to export everything.
note: 58 contact(s) skipped: free version limit (100 of 100 free contacts). unlock contacts in the app to export everything.
note: 1522 conversation(s) skipped: free version limit (50 of 50 free conversations). unlock messages in the app to export everything.
note: 11 day(s) skipped: free version limit (10 of 10 free days). unlock screen time in the app to archive every day.
note: 5 document(s) skipped: free version limit (10 of 10 free documents). unlock documents in the app to convert every one.
```

`status --json` obsahuje úroveň a využitý počet pre Poznámky, Kontakty, Správy a Čas pred obrazovkou. Každá obmedzená aplikácia sa odomyká vlastným jednorazovým nákupom v aplikácii Exporter, [s cenou podľa krajiny](https://exporter.dev/pricing), bez predplatného a bez platby cez web. Príkazový riadok číta nákup pri každom behu; ak App Store neodpovie do 5 sekúnd, beh pokračuje v rámci limitu zadarmo.

## Plánovanie

`exporter help cron` vypíše tieto riadky s úplnou cestou k príkazu na vašom Macu: použite ju, pretože PATH v crone nemusí obsahovať inštalačný priečinok. V crontabe zapíšte `%` ako `\%`:

```sh
0 3 * * * exporter sync
0 3 * * * exporter export --dest ~/Backups/notes-$(date +\%F)
```

Pri Carbon Copy Cloner a ďalších zálohovacích nástrojoch spúšťajte `exporter sync` ako skript pred zálohou a riaďte sa návratovým kódom. Príkaz zostane pripojený počas celého exportu, aj keď ho macOS pozastaví, keď nie je nikto prihlásený. Kým aplikácia beží, s otvoreným aj zatvoreným oknom, `sync` nič nerobí: synchronizácia v reálnom čase už priečinok udržiava aktuálny.

Zálohovací nástroj, ktorý spúšťa svoje skripty ako root (Carbon Copy Cloner to robí), musí `exporter` spustiť vnútri relácie prihláseného používateľa, nie iba ako tento používateľ. Samotné `sudo -u` ho okamžite ukončí s návratovým kódom 133; predraďte mu `launchctl asuser`:

```sh
/bin/launchctl asuser "$(id -u "$CONSOLE_USER")" /usr/bin/sudo -u "$CONSOLE_USER" exporter sync
```

## Server MCP

Lokálny server MCP, vďaka ktorému môžu Claude, Cursor, VS Code a ďalší klienti prehľadávať a čítať vaše exporty, spúšťa aplikácia, nie príkazový riadok, na `http://localhost:8744/mcp`. [Stránka o serveri MCP](https://exporter.dev/docs/mcp) popisuje všetko o ňom, od spustenia po jeho šesť nástrojov.

## Riešenie problémov

Najprv spustite `exporter doctor`; každá neúspešná kontrola vypíše svoje riešenie. [Pomoc](https://exporter.dev/docs/help) pokrýva aj hlásenia aplikácie.

- `X is not authorized`: pridajte priečinok (alebo nadradený) na karte Command Line a spustite znova. `exporter list dests` ukazuje, čo je povolené
- `apple notes is not set up. open Exporter and connect Apple Notes + an export folder.` (to isté pre každú aplikáciu): pripojte ju v Exporteri
- `sync` vypíše, že Exporter beží: nie je čo robiť, aplikácia priečinok udržiava aktuálny. Pre samostatnú kópiu použite `export --dest`
- `no notes were written. run "exporter doctor" to check folders and permissions.`: beh vybral poznámky a žiadnu nezapísal; `doctor` skontroluje priečinky a povolenia
- `bookmark broken`: priečinok bol presunutý, zmazaný alebo jeho zväzok nie je pripojený. Vyberte ho v aplikácii znova
- nainštalovaný príkaz má starý formát alebo cron a zálohovacie nástroje vidia kód 19: vložte inštalačný príkaz znova
- aplikácia sa od inštalácie príkazu presunula: vložte inštalačný príkaz znova
- odomknuté, ale beh hlási free: kontrola nákupu čaká najviac 5 sekúnd a potom pokračuje v rámci limitu zadarmo. Spustite znova
- problém, ktorý doctor nevysvetlí: `exporter report --send --email you@example.com`

## Related

- [Server MCP](https://exporter.dev/sk/docs/mcp): Pripojenie Claude a ďalších agentov
- [Pre agentov](https://exporter.dev/sk/agents): Skills, príkazový riadok a MCP pre agentov
- [Poznámky](https://exporter.dev/sk/docs/notes): Priečinky, polia, HTML a opravy
- [Changelog](https://exporter.dev/changelog): What changed in each version

---

human version: https://exporter.dev/sk/docs/cli
every page: https://exporter.dev/llms.txt