Skip to content

mister11/productive-cli

Repository files navigation

Productive CLI

Build status License MIT Go Report Card codecov

CLI enables you easier tracking on Productive from your terminal.

DISCLAIMER: I do not take any responsibility for incorrectly tracked projects. This is still experimental and visual confirmation in the UI that everything is correct is a must.

Installation

Download ZIP file from releases page and unzip it. Optionally, you can add executable to the path to make it available from everywhere.

Usage

You can look up usage by providing a -h flag to any CLI command (e.g. productive-cli -h).

Login

An explicit login is not necessary. Each action will check local token (stored in ~/.productive/user file) and decide if token is valid or user needs to go through login process.

Tracking

Tracking has 2 available commands:

  • food
  • project

Each command has an optional -d flag to specify a particular date in YYYY-MM-DD format (e.g. productive-cli -d 2020-04-01 track food). In case flag is not provided, command will used today's date.

When asked for time, you can provide number of minutes (e.g. 120) or standard HH:mm format (e.g 8:00; leading zero is optional).

Food

food command will track 30 minutes on food budget. Alongside generic -d flag, you have -w flag to track food for the whole week.

Project

project command enables you to track time for any project you are working on. There are no additional flags - everything is entered interactively after the command is ran.

When command is ran, you'll first see all the projects you've already tracked in the past. If you want to track a new project, press Ctrl+C.

At the moment, there's no nice way to delete already tracked projects. You can edit ~/.productive/projects file where they are saved.