Alas can help you keep in touch with your contacts - family, friends and other people you know. Alas tracks when you last heard from a person and schedules a new task to contact the person if you didn’t hear from them in a while. Alas can also schedule a reminder for a birthday.

Each contact is stored in a separate Markdown file. All contact files should be in a single directory, separate from other Markdown files. For example:

├── contacts
│   ├──
│   ├──
│   ├──
│   ├── ...

Each contact file has the same structure - the contact name, details and the log of communication.

# John Doe

- Birthday: 04-27
- Category: B

## 2022-02-15

Talked over the phone about stuff.

## 2022-01-28

Grabbed a beer and talked about stuff.

The first line is the title that holds the contact name.

Then, there’s a list of details. Each detail has the same structure:

- Detail name: Detail value

A contact can have as many details as you need. However, 2 details are special: Birthday and Category.

If a contact has a Birthday detail and the value matches today’s date, Alas will schedule a reminder to congratulate the person’s birthday.

A contact Category can have one of these 4 values: A, B, C and D. The idea was taken from Derek Siver’s article where categories are defined as:

  • A list: Very important people. Contact every three weeks.
  • B list: Important people. Contact every two months.
  • C list: Most people. Contact every six months.
  • D list: Other people. Contact once a year, to make sure you still have their correct info.