Described here are details about how you can use tracker to send your information from Toggl into codebase and how you can update/rollback the tracker version.
Initial Setup/Configuration
Run
tracker configure
This walks you through the initial setup of the application by requesting your codebase and toggl api keys as well as asking for the toggl workspace you would like to use.
Project Import
Run
tracker project-import
This will ask if you want to import any projects into Toggl from Codebase which are archived or not. Type "y" to import or "n" to skip archived projects.
Attach ticket id to time entry
In order to add a ticket entry to toggl you need to reference it like so in the time description:
[touch: {ticket-id}]
e.g.
[touch: 162]
Also for time to be tracked each entry needs to have the correct project attached. You should have these projects populated in toggl if the project import script has ran.
The touch command will be stripped from the time entry before pushing into codebase so it makes sense to also add an extra description to a time entry like the title of the job or just some general information about what was tracker.
[touch: 162] Fixes a bug with the navigation
You can also just log generic time to a project by not adding the above touch command to the time entry.
Importing Time
Run
tracker-time-update {[today, yesterday, custom]}
In the brackets above select any of the above items. Today will take all times from today and import them, yesterday will do do yesterday and custom will allow you to define a custom time range so you can batch import any time entries.
An example of a custom date range could be something like:
tracker time-update custom 19/09/2017 23/09/2017
Which will import all times between those dates.
Update and rollback
Tracker also comes with update and rollback commands which can be used like below:
tracker update
tracker rollback
Rather than following the installation steps above each time a new version of tracker is available the update command was added in so whenever a release is added with new features and bug fixes the update so that this is much easier.
The rollback command was added so that if a new release has broken some functionality or has introduced a new bug you can run that command to return back to the earlier version of the tool.
Certificate Download
In the header alongside the downloads we also have a certificate installation script. This can be downloaded and ran if the openssl certificates on the mac are out of date. We need to update these for the auto update functionality to get it to work correctly.
Usually this will occur and you need to install wget via the following brew command:
brew install wget
NOTE: If you don't have brew installed you can download it from here
To install the certficates download the install script, navigate to it in the command line and make sure it is executable:
chmod +x install.sh
Then run it:
./install.sh
You may be prompted to type in your password for the script to run.
