All the work for life planning takes place in a workspace. When you use jupiter init in a local directory, you’re starting up your workspace. The local directory and its files, the pages created, etc. are all part of the workspace.

You can have multiple workspaces, and they can even share the same Notion space/account, but realistically it makes sense to use just one. All further concepts we discuss are relative to the workspace.

Workspaces are created via the jupiter init command. jupiter init is idempotent, and is a good way to update workspaces as newer versions of the tool appear.

After creating a workspace, you’ll see something like the following in the Notion left hand bar:

Workspace image

Workspace Properties

A workspace has a name. It is the name of the root page in Notion too.

A workspace also has a timezone. It is usually the timezone in which you live. Internally all times are UTC, but whatever's displayed in the CLI or synced to Notion makes use of this.

A workspace also has a notion of default project. Checkout the projects section for more details about projects. But in context where a project is needed - say when adding a new inbox task, or generating an inbox task from a metric - and none is specified, this one will be used instead.

The space id is specified when calling init. It identifies the Notion "space" where Jupiter will work. It can't be changed after creation though.

Workspace Interactions Summary

You can:

  • Create a workspace via init
  • Set the name, timezone or default project of the workspace via workspace-update or editing the name in Notion directly.
  • See a summary of the workspace via workspace-show.