Sync Notion And Local

Syncing is a periodic action you must perform. It makes sure that all of the changes you've done through Notion are reflected in the local storage.

Usually you'd be doing most of your interaction with Jupiter through Notion - it provides a fancy interface for task creation, big plan management, notes writing, etc. But all the changes you do there aren't automatically copied over to the local storage, hence operations such as task generation, garbage collection, or reporting won't take them into account.

To achieve all the above, you use the sync command. It's enough to run it as:

$ jupiter sync

And it will work its magic, creating new entities in Notion locally, updating modified ones, creating entities on Notion side which are somehow present only locally (perhaps because of some sync error). But it does a bit more. It also updates Notion-side page structures, recreates links between inbox tasks and their big plans or recurring tasks, updates schemas, etc.

Syncing can be very targeted, run juputer sync --help to see the full list of options. But you can:

Notice that sync is the only command which takes data from Notion and applies it locally. Every other command first works locally, and then applies the change to Notion. This means you don't need a sync to mirror local commands or to somehow pull in changes done through the CLI.