Files and iCloud

Plans are documents. Where they live and how they get to your other devices.

Plans are documents

A plan is one file with the ending .clearline. You create, open, rename, duplicate and move it like any other document: in the Finder and the app’s open dialog on the Mac, in the document browser and the Files app on iPad and iPhone.

Changes are saved as you work.

iCloud Drive

Keep a plan in iCloud Drive and it is on every device signed in to your Apple account. Open it on the iPad on site, and the changes are on the Mac when you are back.

Clearline does not run a server and has no account. Syncing is done by iCloud; if you would rather keep plans somewhere else (a local folder, another cloud service that appears in Files), that works too.

Changes from elsewhere

If a plan changes while it is open, because iCloud brought a newer version or the command line tool edited it, the open document takes the new version. It arrives as one undo step, so you can step back.

Avoid editing the same plan on two devices at the same moment. iCloud keeps one version of a file; if both devices save, it will ask you which one to keep.

Plans from the web version

The file format is the same JSON the earlier web version of Clearline stored. Open such a .json file directly; save it as a .clearline document to keep working on it.

Backup

A plan is a small text file. Copy it wherever you keep backups. See File format.