Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

calendarculator

A simple command line tool to calculate how much time people are spending in meetings. We use this at @coinbase to track the hours per week engineers spend in meetings, then goal our teams on reducing that time. If you're interested in joining a team that takes a data driven approach to engineering culture, DM me on Twitter.

Note: this package has only been tested on Node 9

Setup

In order to use this tool, you'll need Google Calendar API credentials. To get credentials, follow Step 1 here to download a credentials file. This will be used to authenticate the requests. With these credentials, you'll be able to see and analyze any calendars you can view in the Google Calendar web interface.

Usage

$ # Ensure you are running on Node 9 or greater
$ npm install -g calendarculator
$ calendarculator --credentials client_id.json --people people.csv --start 4/16/18 --end 4/20/18

┌──────────────────────┬───────────────────┬──────────┐
│ Person               │ Hours in meetings │ Role     │
├──────────────────────┼───────────────────┼──────────┤
│ user@gmail.com       │ 6.5               │ engineer │
├──────────────────────┼───────────────────┼──────────┤
│ user2@gmail.com      │ 6.5               │ engineer │
├──────────────────────┼───────────────────┼──────────┤
│ user3@gmail.com      │ 6.5               │ engineer │
├──────────────────────┼───────────────────┼──────────┤
├──────────────────────┼───────────────────┼──────────┤
│ Mean (All)           │ 6.5               │          |
├──────────────────────┼───────────────────┼──────────┤
│ Median (All)         │ 6.5               │          |
├──────────────────────┼───────────────────┼──────────┤
├──────────────────────┼───────────────────┼──────────┤
│ Mean (Engineer)      │ 6.5               │          |
├──────────────────────┼───────────────────┼──────────┤
│ Median (Engineer)    │ 6.5               │          |
└──────────────────────┴───────────────────┴──────────┘

File Format

user@gmail.com,engineer
user2@gmail.com,engineer
user3@gmail.com,engineer

About

📆 A command line tool to count the hours your team spends in meetings

Resources

Stars

34 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages