boxtime is a command line tool to track your time. It focuses on doing everything with as few keystrokes as possible, because every bit of friction decreases the chance of building a time tracking habit. And only when you habitually track your time can you learn about your time spending patterns and take control of your time!
A CLI tool only goes so far in terms of productivity, however. You still need to switch to your console and type in the commands. To make it really easy to track time, user the Boxtime Alfred workflow, so that tracking your time is only a few keystrokes away from wherever (on your computer) you currently are.
Install the boxtime
command via homebrew:
brew tap thombergs/boxtime
brew install boxtime
Repeat these steps after a time to get the newest version.
If you want to use the Alfred workflow, additionally run:
boxtime alfred install
If that doesn't work for some reason, you can download the Alfred workflow in the latest release and execute it. Alfred should pick it up.
Open your Alfred console (CMD+SPACE by default) and start by typing "t". Boxtime commands will come up and you just need to follow the prompts.
Add the -h
flag to a command to show all available options and arguments.
# print out information about the task you're currently tracking
# and how much time you've tracked today
./boxtime status
# add a new task
./boxtime task add "Reticulate splines"
# list all available added tasks
./boxtime task list
# delete all tasks (mostly used for development to clear the database)
./boxtime task reset
# start tracking a task
./boxtime track start <taskId>
# stop tracking
./boxtime track stop
# log a task without tracking (for example when you forgot to track)
./boxtime track log <taskId> <duration>
# delete all time logs (mostly used for development to clear the database)
./boxtime log reset
BOXTIME_DATABASE_FILE
: Path to the file in which to store the local database. Default:~/.boxtime/boxtime-db
Feel free to reach out via GitHub issues!