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
- Nainštalujte Exporter z Mac App Store (stiahnuť) a otvorte ho.
- 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). Tieto povolenia sa dajú udeliť iba v aplikácii.
- 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
synczapisuje každú aplikáciu vo formáte nastavenom na jej karte (Poznámky a Bear majú každý vlastný) aexportzapisuje podľa nastavenia aplikácie, ktorú exportuje;exporter help syncaexporter help exportukazujú 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 htmlignoruje s poznámkou:note: logseq export is always markdown, so --format is ignored for this source. - Poznámky zapisujú jednu stránku
.htmlna poznámku (formát HTML), prílohy skopírované doattachments/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:
exporter export --dest ~/Backups/notes-md --format markdown
exporter export --dest ~/Backups/notes-html --format htmlsync
Spustí export nastavený v aplikácii, raz, prírastkovo, do priečinkov exportu aplikácie.
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é |
exporter sync --source appleapple notes: exporting…
apple notes: 1204 of 1204 exported · 3 removed · 18.2s · markdown → /Users/me/Documents/notesSú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.
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.
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-runwould export 100 apple notes · markdown → /Users/me/Backups/noteslist
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) |
exporter list folders --json[{"name": "Work", "notes": 42, "level": 0}]status
exporter status [--json]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 runningS --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/.
exporter log [--last N] [--json]| prepínač | čo robí | predvolené |
|---|---|---|
--last N |
koľko behov | 10 |
--json |
jeden objekt na beh | vypnuté |
2026-09-11 03:00 apple-notes 1204/1204 exported 3 removed clean → /Users/me/Documents/notesJSON: [{"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.
exporter doctorKontroluje, ž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.
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émysync,export,list,status,log,doctor,report,cron,install. Pomoc k príkazu ukazuje vaše aktuálne nastavenia ako predvolené hodnotysync,export,list,logareportprijímajú aj--helpalebo-hexporter version(alebo--version,-v) vypíšeexporter 3.24- samotný
exporterv 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:
{
"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):
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, 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 \%:
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:
/bin/launchctl asuser "$(id -u "$CONSOLE_USER")" /usr/bin/sudo -u "$CONSOLE_USER" exporter syncServer 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 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 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 destsukazuje, č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 Exporterisyncvypíše, že Exporter beží: nie je čo robiť, aplikácia priečinok udržiava aktuálny. Pre samostatnú kópiu použiteexport --destno notes were written. run "exporter doctor" to check folders and permissions.: beh vybral poznámky a žiadnu nezapísal;doctorskontroluje priečinky a povoleniabookmark 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
Server MCP 
Pre agentov 
Poznámky