kingoftime-cli/README.md

107 lines
2 KiB
Markdown

King of Time CLI
=================
<!-- toc -->
* [Usage](#usage)
* [Installation](#installation)
* [Commands](#commands)
<!-- tocstop -->
# Usage
```sh-session
$ kot checkin
TODO example output
$ kot checkout
TODO example output
```
# Installation
From the same directory as this README:
```sh-session
$ npm run setup
```
Now the `kot` command should be available on your system.
## Set Tokens
You need to provide two tokens, which can be retrieved by inspecting the HTTP request to `/bprgateway` the
King of Time Web UI makes when submitting a check-in or check-out request.
It is convenient to set these as the below environment variables, although they can also be passed as options
to the `checkin` and `checkout` commands.
* `KINGOFTIME_TOKEN`
* `KINGOFTIME_USER_TOKEN`
# Commands
<!-- commands -->
* [`kot checkin`](#kot-checkin)
* [`kot checkout`](#kot-checkout)
* [`kot help [COMMANDS]`](#kot-help-commands)
## `kot checkin`
Check in
```
USAGE
$ kot checkin --token <value> --user-token <value>
FLAGS
--token=<value> (required) Defaults to the KINGOFTIME_TOKEN environment variable.
--user-token=<value> (required) Defaults to the KINGOFTIME_USER_TOKEN environment variable.
DESCRIPTION
Check in
EXAMPLES
$ kot checkin
```
## `kot checkout`
Check out
```
USAGE
$ kot checkout --token <value> --user-token <value>
FLAGS
--token=<value> (required) Defaults to the KINGOFTIME_TOKEN environment variable.
--user-token=<value> (required) Defaults to the KINGOFTIME_USER_TOKEN environment variable.
DESCRIPTION
Check out
EXAMPLES
$ kot checkout
```
## `kot help [COMMANDS]`
Display help for kot.
```
USAGE
$ kot help [COMMANDS] [-n]
ARGUMENTS
COMMANDS Command to show help for.
FLAGS
-n, --nested-commands Include all nested commands in the output.
DESCRIPTION
Display help for kot.
```
_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.2.9/src/commands/help.ts)_
<!-- commandsstop -->
## Credits
Inspired by https://github.com/inabajunmr/kotrcli