Skip to main content

A Harvest is always better with a good tool

Project description

Scythe

Scythe TUI

Scythe is a TUI and set of CLI utilties for interacting with the Harvest Time tracking Application

Installation

Installable via pip/pipx (pipx is recommended)

pipx install scythe-cli

Setup

First, you need to authenticate Scythe to your harvest account.

To do this, run the following command:

scythe init

This will open a new browser tab to perform an OAuth flow with Harvest. Once you have authenticated, you will be redirected to a page with a code. Copy this code and paste it into the terminal.

Usage

TUI

Start the TUI with

scythe

The interface has the following features:

  • View all timers for a given day
  • Start a new timer
  • Stop a running timer
  • Edit a Timer
  • Delete a Timer

CLI

The CLI also has a few other utilties:

scythe timer - The Scythe Timer namespace has some utilties for interacting with timers. scythe timer --help for more info

scythe projects - List all the projects and tasks that you have access to

Quickstarting

Quickstarting is a feature of Scythe that allows you to start a timer with a single command. This is useful for setting up a timer for a task that you do frequently.

To create a new quickstart entry run:

scythe quickstart add <name>

This will create a new quickstart entry with the name <name>. It will prompt you with a list of projects and tasks to choose from (And optionally, a note & a command to execute after the timer start). Once you have completed the prompt, you can start the timer with:

scythe quickstart <name>

This will start a timer with the details you entered when creating the quickstart entry and will execute the command you entered (if any).

`

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scythe_cli-1.4.2.tar.gz (15.3 kB view hashes)

Uploaded Source

Built Distribution

scythe_cli-1.4.2-py3-none-any.whl (20.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page