The command org-mobile-push copies files listed in
org-mobile-files into the staging area. Files include agenda files
(as listed in org-agenda-files). Customize org-mobile-files to
add other files. File names are staged with paths relative to
org-directory, so all files should be inside this directory153.
Push creates a special Org file ‘agendas.org’ with custom agenda views defined by the user154.
Finally, Org writes the file ‘index.org’, containing links to other files. The mobile application reads this file first from the server to determine what other files to download for agendas. For faster downloads, it is expected to only read files whose checksums155 have changed.
Symbolic links in org-directory need to have the same name as their
targets.
While creating the agendas, Org mode forces ‘ID’ properties
on all referenced entries, so that these entries can be uniquely
identified if Org Mobile flags them for further action. To avoid
setting properties configure the variable
org-mobile-force-id-on-agenda-items to nil. Org mode then relies
on outline paths, assuming they are unique.
Checksums are stored automatically in the file ‘checksums.dat’.