# things-cli

> CLI wrapper around Things URL Scheme

Latest version **0.0.1** (published 2020-09-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install things-cli
pnpm add things-cli
yarn add things-cli
bun add things-cli
```

Provides the command `things`.

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.1 |
| Published | 2020-09-30 |
| First published | 2020-09-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=8.0.0 |
| Dependencies | 5 |
| Unpacked size | 13 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Brian LaMattina @blamattina |
| Maintainers | blamattina |
| Keywords | oclif |

## Links

- npm: https://www.npmjs.com/package/things-cli
- Repository: https://github.com/blamattina/things-cli
- Issues: https://github.com/blamattina/things-cli/issues
- npm.io page: https://npm.io/package/things-cli

## Dependencies (5)

- [tslib](https://npm.io/package/tslib.md) ^1
- [openurl](https://npm.io/package/openurl.md) ^1.1.1
- [@oclif/config](https://npm.io/package/@oclif/config.md) ^1
- [@oclif/command](https://npm.io/package/@oclif/command.md) ^1
- [@oclif/plugin-help](https://npm.io/package/@oclif/plugin-help.md) ^3

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 0.0.1 (latest) — 2020-09-30

## README

things-cli
==========

CLI wrapper around Things URL Scheme

[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
[![Version](https://img.shields.io/npm/v/things-cli.svg)](https://npmjs.org/package/things-cli)
[![CircleCI](https://circleci.com/gh/blamattina/things-cli/tree/master.svg?style=shield)](https://circleci.com/gh/blamattina/things-cli/tree/master)
[![Downloads/week](https://img.shields.io/npm/dw/things-cli.svg)](https://npmjs.org/package/things-cli)
[![License](https://img.shields.io/npm/l/things-cli.svg)](https://github.com/blamattina/things-cli/blob/master/package.json)

<!-- toc -->
* [Usage](#usage)
* [Commands](#commands)
<!-- tocstop -->
# Usage
<!-- usage -->
```sh-session
$ npm install -g things-cli
$ things COMMAND
running command...
$ things (-v|--version|version)
things-cli/0.0.1 darwin-x64 node-v13.11.0
$ things --help [COMMAND]
USAGE
  $ things COMMAND
...
```
<!-- usagestop -->
# Commands
<!-- commands -->
* [`things add TODO`](#things-add-todo)
* [`things add-project PROJECT`](#things-add-project-project)
* [`things help [COMMAND]`](#things-help-command)

## `things add TODO`

Add a to-do

```
USAGE
  $ things add TODO

ARGUMENTS
  TODO  task to add

OPTIONS
  -c, --checklist=checklist  add an item to the checklist
  -h, --help                 show CLI help
  -l, --list=list            [default: Inbox] list to add to
  -w, --when=when            when this should appear in the today view

EXAMPLES
  $ things add testing 1 2 3
  Added 'testing 1 2 3' to 'Inbox'

  $ things add Milk -l="Shopping List"
  Added 'Milk' to 'Shopping List'

  $ things add Milk -w="tomorrow"
  Added 'Milk' to 'Inbox'

  $ things add Shopping List -c="Eggs" -c="Milk"
  Added 'Milk' to 'Inbox'
```

_See code: [src/commands/add.ts](https://github.com/blamattina/things-cli/blob/v0.0.1/src/commands/add.ts)_

## `things add-project PROJECT`

Add a project

```
USAGE
  $ things add-project PROJECT

ARGUMENTS
  PROJECT  project to add

OPTIONS
  -h, --help       show CLI help
  -t, --todo=todo  add a task

EXAMPLES
  $ things add-project chores
  Added project 'chores'

  $ things add-project chores -t="water plants" -t="take out recycling"
  Added project 'chores' with todos: water plants, take out recycling
```

_See code: [src/commands/add-project.ts](https://github.com/blamattina/things-cli/blob/v0.0.1/src/commands/add-project.ts)_

## `things help [COMMAND]`

display help for things

```
USAGE
  $ things help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI
```

_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.0/src/commands/help.ts)_
<!-- commandsstop -->

---
_Source: https://npm.io/package/things-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._