Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/raphexion/nina
Cli for Noko time management
https://github.com/raphexion/nina
cli command-line freckle noko nokotime time-reporting time-tracker
Last synced: 10 days ago
JSON representation
Cli for Noko time management
- Host: GitHub
- URL: https://github.com/raphexion/nina
- Owner: Raphexion
- License: apache-2.0
- Created: 2021-06-29T18:13:07.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-10-31T17:06:49.000Z (about 3 years ago)
- Last Synced: 2023-03-02T19:42:03.479Z (over 1 year ago)
- Topics: cli, command-line, freckle, noko, nokotime, time-reporting, time-tracker
- Language: Go
- Homepage:
- Size: 164 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
```
_ _ _
| \ | (_)_ __ __ _
| \| | | '_ \ / _` |
| |\ | | | | | (_| | - A cli for the Noko Time Tracking Software
|_| \_|_|_| |_|\__,_|
```
[](https://goreportcard.com/report/github.com/Raphexion/nina)
[](https://codecov.io/gh/Raphexion/nina?branch=master)
## Noko (previously Freckle)
[Noko](https://nokotime.com/) 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.
| Person | Project |
|----------|---------|
| Anna | Sales |
| Anna | R&D |
| Bengt | Sales |
| Bengt | R&D |
| Carolina | Sales |
| Carolina | R&D |
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.
## Download
[Latest binaries and packages](https://github.com/Raphexion/nina/releases/latest)
## Configure
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
```
## Usage
Please use the internal help messages at the command-line for an up-to-date usage. Example:
```sh
$ 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.
```