Loopr Docs App →

The Loop

What an item is

An item is anything that wants your attention. It has a title, optionally a description, urgency (1–5), maybe a due date, maybe a URL. It’s in one of three states: queued, snoozed, or completed.

You rarely care about the state directly. What you see is the loop: the ordered list of queued items. Everything else is on the other side of a view.

Creating items

Press c to create a one-off item. You can type natural language for the “snooze until” field — tomorrow, next monday, in 2 hours, 9am, eod, next week, anything reasonable. The AI parses it.

Most items aren’t created manually though. They’re generated by streams — see that page for details.

The UI is vim-flavored. On the loop column:

  • j / ↓ — next item
  • k / ↑ — previous item
  • g g — top of the loop
  • G — bottom
  • h / l — move between the loop column and the streams column
  • ? — help modal with every binding

The selected item is visually centered with a “tunnel” effect — neighbors dim, the selected one sharpens. You can feel where you are without reading.

Acting on the selected item

  • Enter / x — complete it
  • z — snooze; then type how long (2h, tomorrow, eod, next monday)
  • d — delegate to one or more people
  • o — open its URL in a new tab
  • t — toggle top of mind
  • ! — cycle urgency (1 → 2 → 3 → 4 → 5 → 1)
  • u / U — undo / redo the last complete or snooze
  • X — unsubscribe from a Gmail item’s mailing list and complete it

Snooze preserves position

This is the part most people miss at first. When you snooze an item, it disappears, and when its timer’s up it reappears in its original position in the loop, not at the top.

This is on purpose. Snooze is not a trick to escape an item. If you snooze something that was at the top of your loop three weeks ago, it comes back at the top of your loop — not at the bottom, behind everything you’ve accumulated since.

What’s new

When Loopr ships something, the next time you open the app a What’s new item shows up in your loop listing everything released since your last visit. Open it for the details. You can turn these off, reread past updates, or take the guided tour again from Settings → Tour & updates.

Press / to search. Matches appear as you type, scoped to the queued loop. Esc clears the search and returns to the full loop.

The streams column

To the right of the loop, there’s a column of stream cards — the recurring item generators you’ve configured. l focuses it. j/k navigate between streams, Enter edits the selected stream, x pauses or resumes it, Shift+D deletes it (with confirmation), c creates a new one. h goes back to the loop.

Back to app