# node-did

> A dead-simple, cli-based task journaler.

Latest version **1.1.2** (published 2017-02-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install node-did
pnpm add node-did
yarn add node-did
bun add node-did
```

Provides the command `did`.

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.2 |
| Published | 2017-02-21 |
| First published | 2017-01-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 9 |
| Known vulnerabilities | 0 (+2 in 1 direct dependencies) |
| Install scripts | no |
| Author | Chris Allen Lane |
| Maintainers | chrisallenlane |
| Keywords | task, journal |

## Links

- npm: https://www.npmjs.com/package/node-did
- Repository: https://github.com/chrisallenlane/node-did
- Homepage: https://github.com/chrisallenlane/node-did#readme
- Issues: https://github.com/chrisallenlane/node-did/issues
- npm.io page: https://npm.io/package/node-did

## Dependencies (9)

- [rc](https://npm.io/package/rc.md) 1.1.6
- [tmp](https://npm.io/package/tmp.md) 0.0.31
- [chalk](https://npm.io/package/chalk.md) ^1.1.3
- [datejs](https://npm.io/package/datejs.md) ^1.0.0-rc3
- [docopt](https://npm.io/package/docopt.md) 0.6.2
- [sqlite3](https://npm.io/package/sqlite3.md) ^3.1.8
- [text-table](https://npm.io/package/text-table.md) ^0.2.0
- [expand-tilde](https://npm.io/package/expand-tilde.md) ^2.0.2
- [escape-string-regexp](https://npm.io/package/escape-string-regexp.md) ^1.0.5

## Recent versions

- 1.1.2 (latest) — 2017-02-21
- 1.1.1 — 2017-01-18
- 1.1.0 — 2017-01-11
- 1.0.1 — 2017-01-09
- 1.0.0 — 2017-01-09

## README

[![Build Status](https://travis-ci.org/chrisallenlane/node-did.svg)](https://travis-ci.org/chrisallenlane/node-did)
[![npm](https://img.shields.io/npm/v/node-did.svg)]()
[![npm](https://img.shields.io/npm/dt/node-did.svg)]()
[![Known Vulnerabilities](https://snyk.io/test/npm/node-did/badge.svg)](https://snyk.io/test/npm/node-did)

did
===
A dead-simple, cli-based task journaler. It helps you remember what you _did_!

![asciicast](./.github/asciicast.gif)

Installation
------------
`did` can be installed directly from `npm`:

```sh
[sudo] npm install -g node-did
```

Usage
-----
To record an entry:

```sh
did Installed Gentoo.
```

To record an entry using `EDITOR` (will open in the terminal in focus):

```sh
did
```

To view recent entries:

```sh
did log
```

To view recent entries (last 3 only):

```sh
did log -n3
```

To search for entries about Gentoo:

```sh
did log -s gentoo
```

To search for entries about Gentoo between Monday and today:

```sh
did log -s gentoo -f 'last monday' -u 'today'
```

To view the above in ascending order (ie, oldest first):

```sh
did log -s gentoo -f 'last monday' -u 'today' -a
```

To edit entry `2`:

```sh
did edit 2 Hacked the Gibson.
```

To edit entry `2` within `EDITOR`:

```sh
did edit 2
```

To delete entry `2`:

```sh
did delete 2
```

To delete entries `2` and `3`:

```sh
did delete 2 3
```

Tagging
-------
`did` provides full-text searching on log entries, and thus implicitly supports
"tagging":

```sh
$ did Installed Gentoo. +work
$ did Freed Kevin. +personal
$ did Hacked the planet. +work 
$ did log -s +personal
3  Freed Kevin. +personal  06 Jan | 05:29 PM
```

You may choose any tagging convention. Note, however, that `#` must be enclosed
within quotations to prevent the shell from parsing it as a comment:

```sh
$ did 'Hacked the planet. #work'
```

Additional Information
----------------------
Additional information can be found in the [wiki][]:

- [Configuring][]
- [Supported Platforms][]

[Configuring]: https://github.com/chrisallenlane/node-did/wiki/Configuring
[Supported Platforms]: https://github.com/chrisallenlane/node-did/wiki/Supported-Platforms
[wiki]: https://github.com/chrisallenlane/node-did/wiki

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