Sync
Sync moves three things between your devices: your settings, your custom skills, and your chat archives. It works through a plain folder, so there is no Yachiyo account and no server in the middle. Yachiyo recommends iCloud Drive on macOS and OneDrive on Windows, but any folder you keep in sync yourself works the same way.
Set it up in Settings → Sync.
Enabling it
Section titled “Enabling it”- Choose a folder — use the recommended synced folder for the current platform,
or Choose Folder to pick your own. The defaults are iCloud Drive on macOS
and
<OneDrive>\Yachiyo\Syncon Windows. - Hit Enable Sync.
On a second device, the pane offers Join This Device instead, because sync is already initialized in that folder. Joining pulls the existing archives down.
If the recommended folder is unavailable, sign in to iCloud Drive on macOS or OneDrive on Windows. Yachiyo does not invent a path when the service is absent; choose any folder managed by another sync provider instead.
What syncs, and what it costs you
Section titled “What syncs, and what it costs you”Settings and files under skills/custom/ sync bidirectionally. A custom
skill includes its whole directory — SKILL.md, references, assets, binaries,
and scripts. Generated dependency and version-control trees (node_modules and
.git), .DS_Store, and symbolic links are excluded. Bundled skills/core/
content is installed with the app and does not sync.
Chat archives from other devices arrive read-only — you can read a conversation that started on your laptop from your desktop, but you cannot continue it there. Threads stay owned by the device that created them.
Sync runs on its own: a debounced push after changes and a periodic pull, with a single-flight lock so two passes never overlap. Sync Now forces a pass when you do not want to wait.
Conflicts
Section titled “Conflicts”Two devices editing the same setting or custom-skill file produce a conflict, and Yachiyo does not guess. Settings → Sync → Conflicts lists each one. Settings conflicts include the fields that differ; skill conflicts identify the file and the hashes of both versions.
- Keep This Device — your local value wins.
- Use Synced Version — replaces this device’s setting or skill file with the synced one. This is confirmed before it applies, because it is destructive.
- Copy Synced Data — grab the incoming version to inspect by hand.
Once you resolve a conflict, that exact pair of versions is remembered, so the same disagreement is not raised at you again on every subsequent pass.
Status
Section titled “Status”The pane reports one of:
| Status | Meaning |
|---|---|
| Ready | Sync is working |
| Not enabled on this device | The folder has sync in it; join to participate |
| Not initialized | No sync set up in this folder yet |
| Needs attention | Conflicts are waiting for you |
| Sync folder unavailable | The selected folder cannot be reached |
It also shows the device count and how many conflicts are pending.