friendlog
is a simple tool to journal about the time you spend with the people you care about. I hope you enjoy!
Install Node (if you haven't before). Then:
npm install -g friendlog
Add tab-completion and the shortcut flh
for fl hangout
!
fl shortcuts >> ~/.bash_profile && source ~/.bash_profile
$ fl help
You can use friendlog
or fl
.
Add friends and an ideal interval (in days) you'd like to see them:
$ friendlog add Alice 5 # your best friend
$ fl add "Bob Doe" 15 # not quite so close
$ fl add Kunal 10
Log a hangout:
$ fl hangout Alice 2018-01-01 "Got coffee"
$ flh Kunal 2018-03-19 "Created friendlog"
See who you should hang out with next and when:
$ fl list
2018-01-06 Alice
2018-03-29 Kunal
new Bob Doe # no hangouts logged yet
See history of hangouts:
$ fl history
NAME DATE MEMO
Alice 2018-01-06 Got coffee
Kunal 2018-03-29 Created friendlog
See info about friend:
$ fl info Kunal
{ name: 'Kunal', interval: 10 }
Where is my data stored?
All data is stored on your own computer.
What qualifies as a "hangout"?
You can use any criteria you like. I recommend focusing on interaction with intent. You saw and respected the person as another person on Earth and grew together in some small way.
Can you add yourself?
I (Kunal) have started to do this, logging when I do something alone and self-fulfilling (a long run, time with a good book, a fancy meal for one...) This reminds me to "hangout" with myself, too.
I didn't understand this page but I want to try it out!
Email me at [email protected]
.
How can I visualize the data?
You can try using jq
(available for download here). Here's a command I like to see friends grouped by time interval:
jq '.|=group_by(.interval)|map({interval:.[0].interval, names:map(.name)})' < ~/.friendlog/friends.json
Linting is enforced with pre-commit and pre-push hooks. npm run lint-fix
will help!
Publish easily: npm version [major|minor|patch]
will bump version numbers; npm publish
will publish package.