Spatium CLI

This is a reeaaally simple cli for managing timesheets in flat json files, preferably in a git repo (this will become a requirement at some point).

Using this cli in a git repo will give you a sort of ledger, which is really nice.

Installation

It is recommended to create a new Git repo, where you will store the timesheets.

So remember to npm init and then just npm i --save spatium-cli.

We recommend adding a npm script:

{
  "sp": "spatium-cli"
}

Usage

The idea is that you follow a usual development flow. So git pull, do your changes, git commit and git git push.

The cli is done interactively, so it's a breeze to use.

You should start by running npm run sp -- help to get familiar with the cli.

Customers

add:customer There's no arguments for this one.

edit:customer There's no arguments for this one.

delete:customer There's no arguments for this one.

Timesheets

add:timesheet There's no arguments for this one.

edit:timesheet There's no arguments for this one.

delete:timesheet There's no arguments for this one.

Export

--format, -f The output format

• [choices: "csv", "json", "pdf", "html", "xlsx"]
• [default: "csv"]

--directory, -d Output directory

• [default: "out"]

--customer, -c Customer id

--from From date (iso)

--to To date (iso)

--all Export all customers in all formats

--dropbox Upload to dropbox - remember to login

Reports

report:monthly Gives a nice cli table view of the current month.

Integrations

integrate:dropbox login Start the dropbox login flow.