> **Announcement:** I'm back maintaining mind
> I halted maintaining this project for some time since I wasn't using it.
> But I eventually started using it again with a somewhat different workflow.
> I'm glad that the simple and minimalistic nature of this tool turned out to
> be suitable for multiple productivity workflows. So, I'll hardly be adding
> more features to it. But improving the current features and apis could be
> done.

# A productive mind has an empty stack

[![Crates.io](https://img.shields.io/crates/v/mind.svg)](https://crates.io/crates/mind)

[![asciicast](https://asciinema.org/a/345440.svg)](https://asciinema.org/a/345440)

## The philosophy

[mind](https://github.com/sayanarijit/mind) follows the following philosophy

> **_A productive mind has an empty stack._**

Explaination:

Sometimes we have too much on our mind but neither the traditional check boxes, nor
the kanban board works for us. This is because our mind executes the tasks in
[LIFO](<https://en.wikipedia.org/wiki/LIFO_(education)>) approach like a
[stack](<https://en.wikipedia.org/wiki/Stack_(abstract_data_type)>).

The longer we hold a task in the stack of our mind, the more productivity it will
lose. Also, trying multitasking with this stack can cause unpredictable results.

We need to execute them as early as possible. But one by one.

[mind](https://github.com/sayanarijit/mind) makes it easy to work with the stack
of our own mind. It uses this simple formula to measure the current productivity
level of our mind and uses the appropriate colors to represent the state.

> **_p = O - b_**
>
> Where **_p_** is productivity, **_O_** is the optimal (desired) productivity,
> and **_b_** is backlog.

In other words, the more tasks you keep on your mind and the longer you keep them
there, the less productive you will become.

You want to keep this stack empty.

## Install

You need [cargo to install mind](https://www.rust-lang.org/tools/install).

```bash
cargo install mind
```

## A productive mind can push and pop tasks into it's stack efficiently

Push tasks into the mind stack (or continue with an existing task)

```bash
mind

# Enter the names for the tasks to push.
# Press [ENTER] again to save the added tasks.
```

Pop the current task from the mind stack

```bash
mind pop

# Alias
mind p
```

Or while in interactive mode

```bash
/pop

# Alias
/p
```

Supported commands in both CLI and interactive mode

| Command        | Aliases | Action                                        |
| -------------- | ------- | --------------------------------------------- |
| {num}          |         | Continue with the task at the given position  |
| pop            | p       | Pop out the current task                      |
| pop {num}      | p {num} | Pop out the task at the given position        |
| edit           | e       | Edit the current task                         |
| edit {num}     | e {num} | Edit the task at the given position           |
| edit reminders | e r     | Edit the reminders                            |
| get            | g       | Get details of the current task               |
| get {num}      | g {num} | Get details of the task at the given position |
| remind         | r       | Turn the current task into a reminder         |
| remind {num}   | r {num} | Turn the specified task into a reminder       |

## Examples

Example 1: Add all the `TODO` and `FIXME` items from the codebase.

```bash
grep -nR TODO . | mind
grep -nR FIXME . | mind
```

Example 2: Continue with the task positioned at `[3]`

- CLI mode

```bash
mind 3
```

- Interactive mode

```bash
/3
```

Example 3: Pop the task positioned at `[3]`

- CLI mode

```bash
mind p 3
```

- Interactive mode

```bash
/p 3
```

Example 4: Edit the task positioned at `[3]`

- CLI mode

```bash
mind e 3
```

- Interactive mode

```bash
/e 3
```

Example 5: Get details of the task positioned at `[3]`

- CLI mode

```bash
mind g 3
```

- Interactive mode

```bash
/g 3
```

## A productive mind can remind itself of the pending and repeating tasks

```bash
mind edit reminders

# Or

mind e r

# Or in the interactive mode

/e r
```

Add the reminders in the following format

```yaml
# This reminder will disappear once executed.

- name: Test reminder once on 10 July 2020, at 8 am IST
  when: "2020-07-10T08:00:00+05:30"
  repeat: Never

# The following reminders will reschedule themselves.

- name: "Test reminder everyday at 10:30 pm IST"
  when: "2020-07-10T22:30:00+05:30"
  repeat: EveryDay

- name: "Test reminder every other day at 10:30 pm IST"
  when: "2020-07-10T22:30:00+05:30"
  repeat:
    EveryNthDay: 2

- name: Test reminder every week at 11 am IST
  when: "2020-07-10T11:00:00+05:30"
  repeat: EveryWeek

- name: Test reminder every 3rd week at 11 am IST
  when: "2020-07-10T11:00:00+05:30"
  repeat:
    EveryNthWeek: 3

- name: "Test reminder every saturday and sunday at 9:15 am IST"
  when: "2020-07-10T09:15:00+05:30"
  repeat:
    Weekdays:
      - Sat
      - Sun

- name: "Test reminder every 2nd saturday at 9:15 am IST"
  when: "2020-07-10T09:15:00+05:30"
  repeat:
    EveryNthWeekday:
      n: 2
      weekday: Sat
```

I'll keep adding features (small or big) and keep improving the code quality
while I learn more cool ways to be productive and become a better developer.