Sync with iCloud

Ayumi uses iCloud Drive for seamless synchronization across your Apple devices.

How It Works

Ayumi stores all entries as Markdown files in a folder you choose. When that folder is on iCloud Drive, Apple handles the syncing automatically.

• No account registration required
• No Ayumi servers involved
• Files sync through Apple’s iCloud infrastructure

Setting Up Sync

1. During initial setup, select a folder inside iCloud Drive
2. That’s it — sync is automatic

On your other devices:

1. Install Ayumi
2. Select the same iCloud Drive folder
3. Entries will appear automatically

Use synced transcripts with AI

Markdown synced to your Mac can be read through a Codex project or Claude Desktop’s connected folder. Use your spoken notes as background for reflection, planning, and development.

See Use Transcripts as Context in Codex and Claude for folder setup and the conditions for continuing from mobile. Configure file access and remote connections in the AI app as well as iCloud sync.

Conflict Handling

If the same entry is edited on multiple devices simultaneously, Ayumi detects conflicts using file modification dates and content hashes. You will be notified of any conflicts so you can resolve them.

Sync Without iCloud

If you prefer not to use iCloud, you can:

• Choose a local folder and sync it manually
• Use any third-party file syncing service that works with folders (e.g., Syncthing)
• Since entries are plain Markdown files, any file-level sync tool will work

Troubleshooting

Issue	Solution
Entries not appearing on another device	Ensure both devices use the same iCloud Drive folder
Sync seems slow	iCloud Drive sync timing is managed by Apple — large files may take time
Missing attachments	Check that iCloud Drive has downloaded the files (not “cloud” placeholders)