Scythe is a TUI and set of CLI utilties for interacting with the Harvest Time tracking Application
Installable via pip/pipx (pipx is recommended)
pipx install scythe-cli
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.
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
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 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).
`