Metrics are a measure of the evolution in time of some aspect of your life. It is often useful to quantify certain aspects of your life, and keep special tabs on it. Metrics allow you to track your weight, your retirement savings, days gone to the gym, miles run, etc.

In the workspace overview, you can view the set of metrics:


Each metric contains many entries or records, for example:

Metric entries

Much like projects, metrics are created via the jupiter metrics-create --metric $smartListKey --name "Metric Name" command. The command is idempotent. The key plays the same part it does for a project, is a unique identifier for the metric, and must be some nice string with no spaces or funny characters like books or movies. It will be used as a reference to the project in other commands.

Metrics have a name. It's the nicely looking counterpart to the key.

Metrics can also have a unit. It adds extra info about what exactly you're recording - weight, currency, the count of an event, etc.

Metrics can also have a collection period. This isn't yet used.

Interaction Summary

You can:


Metric entries are the records of the value of a certain metric at a certain time.

Metric entries have a collection time - the time they were recorded.

They also have a value - the actual value for the metric at that particular time.

Metric entries can also have some notes attached to them, for any extra info you might want to add.

In general, you're going to create entries from Notion, and use sync to bring them over to the local store.

Entries Interaction Summary

You can: