A terminal queue for your attention

One thing in front of you.
Everything else in the box.

mm is a tiny command-line queue. Put a task in, and mm shows exactly one. Finish it, and the next one appears. An interruption stacks on top and unwinds; an idea waits behind the work you were already doing.

No list to re-rank. No calendar to negotiate. No feed that starts without asking you.

Install for macOS
git clone https://github.com/Toseef-Ahmad/mm.git && cd mm && ./install.sh

Python 3.11+ Zero dependencies One state file MIT

01

No config file

Nothing to tune before you start. No daily seed, no habits, no projects, no gates.

02

No daemon

mm does nothing until you type it. There is no background process and no account.

03

No repeats

Tomorrow is empty unless you add something again. The box holds only what you put in.

01 — The problem

Two ways a day gets away from you.

Both happen in the same place: the second between one piece of work and the next. mm is built for that second.

01 The gap

A gap with nothing queued becomes a scroll, or the next episode.

You finish something, or a build is running, and for a minute nothing is in front of you. The feed starts without asking you to decide — and the hour is gone.

The fix Put the next real thing in the queue before the gap opens. When it does, type mm. The next thing is already there.

02 The idea

An idea mid-work has nowhere to sit. So it tugs, or it disappears.

You are studying, or deep in a task, and a thought arrives that does not belong to the current work. Keep it in your head and it pulls at you. Chase it and the work is gone.

The fix mm add "write this up later" puts it behind what you are doing. You stay on the work. When you finish, the idea is next.

A list after you finish

“CS302 is done. Now choose again.”

Scan the list. Re-rank it. The phone is easier.

mm after you finish

$ mm done
✓ done  1  CS302
→  2  write this up later   active

The idea was already next. No new choice.

02 — How it works

Three places. One thing on screen.

A queue for work, a stack for interruptions, and a drawer for small nags. Nothing else.

One afternoon

Seven commands. Watch the box change.

Step 1 of 7
mm add "CS302"
+ queued 1 CS302

You’re about to study. Put it in the box, so your head can do the studying.

The box live state
Now Queue
CS302
stack 0 items
queue 1 item
quick 0 items
01 Default work

Queue

First in, first done.

The work you meant to do. An idea added mid-task goes at the back, so the thing you are on stays the thing you are on.

$ mm add "CS302"
02 Real urgency

Stack

Last in, first done.

Something just became more important. It takes the front. Finish it and you are back on the queue, on the same work, in the same place.

$ mm add -p "prod is down"
03 Small nags

Quick

Off the line.

Email, a chore, a thing that must not jump the queue. mm never shows it as the next thing. Clear the drawer when you choose to.

$ mm add -q "email Sam"

03 — Everything it can do

The whole command set.

No hidden modes. No plugins. These are all the verbs, grouped by the moment you need them.

Capture & start

mm add "task"
Put work in the queue. Add -p for an interrupt, -q for quick.
mm
Show the one thing to do now and start its timer. Same as mm next.
mm peek
The same glance without starting the timer.
mm done [id]
Finish the active item, or the given id, and advance to the next.

When the work is stuck

mm block ["reason"]
Stuck waiting on someone? Requeue it and move on.
mm unblock <id> [--front]
Clear a block. A queue item can jump back to the front.
mm suspend [id]
Park an item without finishing it.
mm resume [id|--all]
Bring one parked item back, or restore all of them.

Change the line

mm move <id> queue|stack|quick
Reclassify an item. Add --front to put it first.
mm edit <id> "text"
Replace what an item says.
mm note <id> "note"
Attach context without changing the task.
mm rm <id>
Remove an item entirely.
mm find "query"
Search open items and the archive.
mm undo
Reverse the last change from the saved snapshot.
mm flush-quick
Empty the quick drawer at a checkpoint. It is not archived.

Look back

mm status
Show all three containers at once.
mm stats
Today’s counts. No cheerleading.
mm archive [today]
Finished items, all time or just today.
mm export [json|md|csv]
Dump open items and the archive in the format you pick.
mm log [n]
Recent events. Ten by default.
mm help
Open the full manual. Also available as man mm.

04 — Why this shape

The limits are real. The trick is not.

mm is built around working memory, the cost of leaving a task, and writing a thing down so you can stay on the work. It does not depend on a memory illusion.

Cowan, 2001

About four chunks

Working memory holds roughly four chunks when you are not rehearsing them. A long list is already more than your head can keep.

So mm shows one thing.

Risko & Gilbert, 2016

Write it down

Putting a task into a reliable place outside your head frees attention for the work itself. The capture has to be one line.

So mm add "…" is the whole capture.

Leroy, 2009

Attention residue

Leaving a task unfinished leaves part of your attention on it. The stack is a boundary: do the interruption, then mm done puts you back.

So the way back is a command.

Mark, office studies

About 23 minutes

Returning to the original task after an interruption takes on the order of twenty minutes. The queue is the written return address.

So the address is already written.

05 — Beside the other ways

Same urge to capture. A different next step.

  In your head A todo list A calendar Notes and tabs mm
What you do next You rehearse the list instead of doing the work. It stores the tasks, then asks you to choose again. It decides when. Real interruptions blow the slots. They hold the words. They do not name what is next. Shows one thing. Never takes the clock.
When something urgent arrives The old work stays in your head while you do the new one. Another row. The place you were is somewhere in the backlog. You reschedule by hand. Another tab, another scrap. mm add -p. mm done puts you back.
Getting Things Done Same first move: get it out of your head. Then projects, contexts, and a weekly review. Stops at the three places.

06 — Install

One file. Nothing running in the background.

mm is a Python 3.11 program using only the standard library. No pip packages, no daemon, no account. State lives in ~/.mm/state.json — one file, locked and saved atomically, with an undo snapshot.

  • Two terminals cannot tear the state file.
  • mm undo restores the previous snapshot.
  • The full manual ships as man mm.
  • Version 3.0.0, MIT licensed.
Source install puts mm on your PATH

macOS / Linux

git clone https://github.com/Toseef-Ahmad/mm.git
cd mm && ./install.sh

Windows · Command Prompt or PowerShell

git clone https://github.com/Toseef-Ahmad/mm.git
cd mm
install.cmd

Windows · one line from PowerShell

irm https://raw.githubusercontent.com/Toseef-Ahmad/mm/master/install.ps1 | iex

Or pipx install git+https://github.com/Toseef-Ahmad/mm.git. If Python 3.11+ is missing, the Windows installer fetches it with winget.