Smart Lists

Smart lists are list for recording things! Organised people often keep lists. For example of things they've done or plan to do. And they can be for anything: movies, books, courses, songs, places, restaurants, etc. Lists are good for long term planning as they can allow the construction of a plan outside of the formal constraints of big plans.

In the workspace overview, you can view the set of smart lists:

Smart lists

Each smart list contains many items, for example:

Smart list items

Much like projects, smart lists are created via the jupiter smart-lists-create --smart-list $smartListKey --name "Smart List Name" command. The command is idempotent. The key plays the same part it does for a project, is a unique identifier for the smart list, 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.

Smart lists have a name.

They also have an icon, which is a nice unicode glyph like 📖 or 🍺 which serves to visually distinguish the smart list.

Interaction Summary

You can:

  • Create a smart list via smart-list-create.
  • Remove a smart list via smart-list-archive.
  • Change the name via smart-list-update, or by changing the name of the page in Notion.
  • See a summary of the smart lists via smart-list-show.

Items

Smart list items are the actual books you want to read, movies you've seen, or courses you've attended. They are attached to a particular smart list.

For example, you can have a smart list item like "The Godfather", or "Trafalgar Square", in your list of movies, and places to visit, respectively.

Smart list items have a name.

Smart list items also have a notion of doneness. Many many times lists are built in order to act somehow on them - go to a place, read a book, etc. To support this out of the box, items can be marked as "done".

Smart list items also have tags. You can use them to classify them or to keep track of info you otherwise can't right now (author, year of publication, etc).

Smart list items also have an optional url. It can be used to provide extra information about the particular item, such as an Amazon link where it can be bought, or the actual link of the actual interesting article you want to read.

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

Items Interaction Summary

You can:

  • Create a smart list item via smart-list-item-create, or by creating a new entry in the appropriate Notion table.
  • Remove a smart list item via smart-list-item-archive, or by clicking the archive checkbox in Notion.
  • Change the doneness status via smart-list-item-update, or by clicking on the checkbox in Notion.
  • Change the name of a smart list item via smart-list-item-update, or by changing the name from the Notion row.
  • Change the tags of a smart list item via smart-list-item-update, or by changing the tags from the Notion row.
  • Change the url of a smart list item via smart-list-item-update, or by changing the URL field from the Notion row.
  • There is a whole suite of smart-list-tag-* commands for create/update/archival of tags.