I use Objectives and Key Results both for my personal and professional life (OKRs on Wikipedia). This repository is the source of truth of my progress for my personal goals. I update these numbers weekly.

API: https://anandchowdhary.github.io/okrs/api.json

If you want your own OKRs tracker, you can fork this repository and set up the repository with the following file structure:

├── README.md
├── .github
│   └── workflows
│       └── node.yml
└── okrs
    ├── 2019
    │   ├── 3.md
    │   └── 4.md
    └── 2020
        └── 1.md

Using GitHub Actions, api.json and README.md will be auto-generated. When creating new OKRs for a quarter, follow the JSON schema by duplicating one of the files in the ./okrs directory:

{
  "$schema": "https://anandchowdhary.github.io/okrs/schema.json",
  "year": 2021,
  "quarter": 4,
  "objectives": [
    {
      "name": "Objective 1",
      "key_results": [
        {
          "name": "Key result 1",
          "target_result": 10,
          "current_result": 1
        }
      ]
    }
  ]
}

You can use the git commit history as a way to track progress of an OKR, for example looking at the history of my Q4 2021 OKRs: https://github.com/AnandChowdhary/okrs/commits/main/okrs/2021/4.json. A more sophisticated system can be set up that tracks changes to one line using git log like so:

git log -L17,+1:'okrs/2021/4.json'

• Code in the scripts directory: MIT © Anand Chowdhary
• Content in the okrs directory: CC BY 4.0 © Anand Chowdhary
• "GitHub" is a trademark of GitHub, Inc.