toggl-cli is a command-line interface for toggl.com.
It certainly does not implement the full toggl API, but rather some core functions. The goal is to make using toggl quicker and more efficient for those already familiar with command-line tools.
toggl-cli is written in Python and uses version 8 of the toggl API (thanks to beauraines for the help).
15 Dec 2014: Thanks to FedericoVaga
.togglrc now supports API token authentication. You will need to add
api_token to the auth section, and prefer_token to the options section.
11 Nov 2014: Major refactoring into a more MVC OO structure.
30 Oct 2014: Added a feature that starting, stopping, and continuing an
entry prints out the time it started or stopped. This requires a new option in
~/.togglrc: time_format = %I:%M%p is the default. See
strftime()
for more options.
- iso8601 module
- pytz module
- requests
- dateutil
Upon first running the program, a configuration file ~/.togglrc will be
automatically created.
- Update that file with your toggl username and password.
- Update the timezone entry (e.g. US/Pacific).
- When creating a time entry for a given project, the project must already exist.
- Project users, tasks, tags, and users aren't supported.
- Only the default workspace is supported.
See the issues tracker
Usage: toggl [OPTIONS] [ACTION]
Options:
-h, --help show this help message and exit
-q, --quiet don't print anything
-v, --verbose print additional info
-d, --debug print debugging output
Actions:
add DESCR [@PROJECT] START_DATETIME ('d'DURATION | END_DATETIME)
creates a completed time entry
clients
lists all clients
continue DESCR
restarts the given entry
ls
list recent time entries
now
print what you're working on now
projects
lists all projects
rm ID
delete a time entry by id
start DESCR [@PROJECT] [DATETIME]
starts a new entry
stop [DATETIME]
stops the current entry
www
visits toggl.com
DURATION = [[Hours:]Minutes:]Seconds