A great time tracking tool.
Use natural language and simple text based interfaces to track time on projects.
Tickbin requires Node.js v4.2 or greater.
npm install -g tickbin
commits time entries
tick commit "8am-12pm fixed a bunch of bugs" # records time for todaytick commit "yesterday 9pm-11pm late night code" # records time for yesterdaytick commit "Jan 1 12am-1am partied!" # records time for Jan 1tick commit "12pm-1pm great #lunch at Mervo's" # add #tags anywheretick commit "4 hours 15 minutes no specific time" # record durations without start/end
display time entries
tick log # shows you all your time entries for the past weektick log -f "jan1-31" # entries for Jan 1-31tick log -f "jan - feb" # entries for Jan 1-Feb 28tick log -f "#lunch" # entries tagged with #lunchtick log -f "#dev and #bug" # entries tagged with #dev AND #bugtick log -f "#dev or #design" # entries tagged with #dev or #designtick log -f "#dev and not #nobill" # entries tagged with #dev but not #nobilltick log -f "#dev or #design May - June" # #dev or #design from May to June
start a timer
tick start # starts a timer for the current timetick start "8am" # starts a timer for 8amtick start "8am squashing some bugs #dev" # starts a timer for 8am and provides a message
stop a timer and commit an entry
tick stop # stops a timer and creates an entry for the durationtick stop "10am" # stops a timer as of 10amtick stop "10am creating bugs :( #dev" # stops a timer as of 10 and provides a commit message
tick cancel-timer # cancels the current timer without creating an entry
remove a time entry
tick rm 4yKrumkjl # remove time entry with id 4yKrumkjl
register for a tickbin.com account
tick register # asks you for username, email, password then creates an account with a couchdb for you
login to tickbin, sets up syncing
tick login # asks you for username and password and sets remote in .tickbinrc
sync local db with the remote
tick sync # syncs your local db with the remote db
upgrades entries between releases
tick upgrade # upgrades your tickbin database when new tickbin is released
tickbin is a simple time tracking application with an emphasis on minimizing disruption to the user. It accomplishes this by:
- natural language input (no need to fill out forms or click buttons)
- quick in and out interfaces (text based interfaces wherever users work: cli, slack, alfred)
- offline priority (internet should not be a requirement)
tickbin emphasizes user data ownership:
- open source client with local data storage
- optional self hosted data replication (via couchdb)
- premium integrations via hosted service for portability
Local database path will default to
~/.tickbin. If you would like to specify a custom location, add the following to
If you're developing you can add a
.tickbinrc file to your development directory.
To sync with a remote database, add the following to
tick sync in order to sync your database with your remote server.
Copyright (©) 2017 Two Story Robot Labs Inc.
Lead Maintainer: Jonathan Bowers