https://github.com/mister11/productive-cli

Time tracking CLI for https://productive.io
https://github.com/mister11/productive-cli

cli go productive timetracking

Last synced: 3 months ago
JSON representation

Time tracking CLI for https://productive.io

• Host: GitHub
• URL: https://github.com/mister11/productive-cli
• Owner: mister11
• License: mit
• Created: 2020-04-03T00:14:48.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-09-01T14:29:16.000Z (over 5 years ago)
• Last Synced: 2024-06-20T10:12:03.878Z (almost 2 years ago)
• Topics: cli, go, productive, timetracking
• Language: Go
• Homepage:
• Size: 75.2 KB
• Stars: 1
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Productive CLI

![Build status](https://github.com/mister11/productive-cli/workflows/Build/badge.svg) [![License MIT](https://img.shields.io/badge/License-MIT-brightgreen)](https://github.com/mister11/productive-cli/blob/master/LICENSE) [![Go Report Card](https://goreportcard.com/badge/github.com/mister11/productive-cli)](https://github.com/mister11/productive-cli) [![codecov](https://codecov.io/gh/mister11/productive-cli/branch/master/graph/badge.svg)](https://codecov.io/gh/mister11/productive-cli)

CLI enables you easier tracking on [Productive](https://productive.io) 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](https://github.com/mister11/productive-cli/releases) 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.