I personally don't like productivity tools, but I thought it might be useful to have a super minimal command-line utility that could help me catch myself if I start getting lazy about certain habits. My-progress aims to be a tool that, given the least amount of input possible, will help you hold yourself accountable to your productivity goals.

You should be able to call my-progress easily from anywhere in the terminal, so first add a simple alias to my-progress to your dot file. Your alias should point to src/progress.js in this repo and will look something like this: alias mp='node /Users/cool.guy/cool-projects/progress/src/progress.js' I will continue to use the mp alias throughout this documenation.

mp new-user ${name}

This command adds a new user to my-progress and set the current user to be the new user. Any subsequent commands will update the information of this new user.

Example:
mp new-user bob

mp tasks ${list of tasks}

This command adds one or more tasks to the user. This is how you set the particular tasks that you want to track. You cannot "complete" a task unless you have first added it with this command. This is kind of like a very general daily TODO list, so this is just adding tasks to the list.

Example:
mp tasks read dance write guitar

mp complete ${task}

Sets the task to completed for today.

Example:
mp complete read

Sometimes you might forget to complete a task and want to update you log the next day. To do that you can use the --days-ago option:
mp complete --days-ago=${number} ${task}

Example:
mp complete --days-ago=2 exercise

mp status

Outputs a progress report for the current user. This report will contain warnings and alerts based on how long it has been since you last completed a task.

Example:

$ mp status

- - - Productivity Report for james - - -

ALERT!!! It has been 3 days since you completed "read"!

Good job! You completed the task "music" today.

mp static

Generates an index.html file with a table that illustrates your task completion over time. While the status command can warn you about areas where you are lagging behind, the table is better for observing long term trends.

mp user ${name}

Changes the current user.

My-progress maintains a single file containing information about all users and a separate file for each user containing their task history. Each file is JSON format which are consumed by the program, modified, and the re-written in their entirety to disk. It would probably be more performant to use a simpler text format for the task history file that would allow append operations, but at this early stage I am using the simplest possible implementation.

• generate a chart of task history in the terminal