raphexion / nina Goto Github PK

 _   _ _
| \ | (_)_ __   __ _
|  \| | | '_ \ / _` |
| |\  | | | | | (_| | - A cli for the Noko Time Tracking Software
|_| \_|_|_| |_|\__,_|

Noko is a time tracking software tool. Nina is a command-line tool to directly interact with Noko through the Noko API.

In Noko, each project has a timer. However, it is tied to specific user. For example, if your organization has two projects: Sales and R&D and three employees: Anna, Bengt and Carolina. Then are six timers.

That means, that if you are Anna. When you want to start/pause/log a timer, you actually only need the project name. This timer will not conflict with Bengt's and Carolina's timers for the same project.

Latest binaries and packages

Please create a Personal Access Token in Noko (web page). On the right hand side, open Connected Apps & API. Then look for NOKO API and Personal Access Tokens.

Either create an environmental variable

export NOKO_ACCESS_TOKEN="my-key-1234"

Or, create nina.yaml in your home folder:

# ~/nina.yaml
access_token: my-key-1234

Please use the internal help messages at the command-line for an up-to-date usage. Example:

$ nina
A commandline client written in golang to help interact with Noko time tracker

Usage:
  nina [command]

Available Commands:
  entries
  help        Help about any command
  projects
  timers

Flags:
      --config string   config file (default is $HOME/nina.yaml)
  -h, --help            help for nina

Use "nina [command] --help" for more information about a command.