Installing

Using NPM

Install it by running npm install -g simple-toggl

Using Docker

Build the container.

docker build . -t simple-toggl

Create an alias to run the container (ex. .bashrc). :tada:

alias toggl='docker run -e TOGGL_TOKEN=your_toggl_api_token simple-toggl'

Set up

API Token

To use simple-toggl, you must provide an api-token. This can be done via the set-token command. Information on where you can get your token can be found here.

toggl set-token <your-api-token>

(Optional) Project ID

If you're working on the same project, you can set a default project ID. This way, all your time entries will default to the same project.

toggl set-pid <pid>

Usage

current entry

Get the current entry if one exists. This is the default command.

toggl

todays entries

Get a list of today's entries.

toggl day

start

Starts a new time entry. Will stop the current entry if one is running.

toggl start my-awesome-task

stop

Stops the current entry if one is running.

toggl stop

set-token

Sets an api token to authenticate you.

toggl set-token <your-api-token>

set-pid

This is optional. Set a project id for your tasks.

toggl set-pid <pid>