> For the complete documentation index, see [llms.txt](https://j-osler.gitbook.io/wdid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://j-osler.gitbook.io/wdid/master.md).

# WDID

What Did I Do (wdid) is a small CLI tool to track what you have been working on. You can `add`, `list`, `edit`, `do`, `skip`, `bump`, `show` and `rm` [*items*](/wdid/working-with-items/untitled-1.md). There's [tagging](/wdid/working-with-items/tags.md) built in, and the ability to [list](/wdid/working-with-items/viewing-items-1.md#list) and [filter](/wdid/advanced/filters.md) your items by tag, status, and time. Using these filters, you can organise your data however you like with [groups](/wdid/advanced/groups.md). It's very fast and flexible. Here's a sample of what you can do (run it yourself to see the lovely colors!), though you can do an awful [lot more](/wdid/advanced/tips-and-tricks.md#effective-grouping-with-tags-examples); such as organising projects, areas of work, time frames, taking notes etc...

![terminal screen shot](https://user-images.githubusercontent.com/167061/68556700-4e199800-0401-11ea-9e81-cdf948663f62.png)

#### Add an item

```
$ wdid add "my item for #project"
⇒ w9hjba -- Fri, 09 Nov 2019 15:03:08
Tags: [#project]
Data:
my item for #project
```

#### List items with filters

```
$ wdid "tag=#project,status=waiting"

- Thu Nov 07
⇒ o2wjb9     send email to @josler about #project [@josler #project]

- Fri Nov 08
⇒ w9hjba     my item for #project                 [#project]
```

#### Take action on items

```
$ wdid do o2w
✔ o2wjb9 -- Thu, 07 Nov 2019 00:00:00
Tags: [@josler #project]
Data:
send email to @josler about #project
```

### Why command line?

I spend much of my time with a terminal open. It's *right there*, always a cmd-tab away. Being able to quickly record notes without having a website open, or having some app consuming memory is really useful.

I also want to make sure that the data is easily accessible, and works with other tools wherever possible. Building on the command line enables that "for free". Your data is exportable, and we have different output formats for both humans to consume and for interop with various tools (json and structured text outputs!)

### Why personal?

This is a tool to track your personal to-do's, work done, notes, etc. It deliberately eschews complexity added by networking, sharing, and large-scale project management. In doing this it can remain, small, simple, fast, and useful.

####