sayanarijit / mind

A productive mind has an empty stack
https://mind.cli.rs
MIT License
48 stars 1 forks source link
command-line reminder rust tasks todo

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

asciicast

The philosophy

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 approach like a stack.

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 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.

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)

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

mind pop

# Alias
mind p

Or while in interactive mode

/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.

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

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

mind 3
/3

Example 3: Pop the task positioned at [3]

mind p 3
/p 3

Example 4: Edit the task positioned at [3]

mind e 3
/e 3

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

mind g 3
/g 3

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

mind edit reminders

# Or

mind e r

# Or in the interactive mode

/e r

Add the reminders in the following format

# 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.