Skip to content

Repository files navigation

Superlist Assist

The quiet layer on top of Superlist that thinks about your tasks so you don't have to.

Every morning it tells you what's on, what closed yesterday, and what's been sitting too long. Captures tasks wherever you are. Stays out of the way the rest of the time.


A morning with Superlist Assist

You open Claude Code. Before you type anything:

☀️ Tuesday morning. 3 of 4 closed yesterday, 1 carries over.

Working
   · Proposal sent
   · Called the accountant

Today (4)
   Follow up with Sarah · 3 days overdue
   Review lease renewal · moved twice
   Book dentist
   Pick up dry cleaning

   **Start with:** Follow up with Sarah (3 days overdue)

Any other task to add?

You type "remind me to book annual review by friday" — captured, dated, routed to Work. That's the whole morning ritual.


Commands

Command What it does
/superlist-assist:todo Capture. Type one task, scan the conversation, or paste text to extract from.
/superlist-assist:brief Today's view. Auto-surfaces the first time you open Claude Code each day.
/superlist-assist:recap [week] Summary of any window — week, month, since Monday.
/superlist-assist:review Walk through stale tasks one at a time. Auto-surfaces on Mondays.
/superlist-assist:config Change settings, lists, thresholds.

Autocomplete gets you there fast — type /su and tab through. Natural language works too:

> what's today look like       → brief
> add call dentist tomorrow    → captured
> what have I been ignoring    → review
> show me last week            → recap week

Install

Requirements: Claude Code + a Superlist account.

In any Claude Code session, run:

/plugin marketplace add superlistapp/superlist-assist
/plugin install superlist-assist@superlist-assist

Claude Code will prompt you to authorize the Superlist MCP the plugin ships with. Approve it — a browser tab opens for Superlist OAuth. That's the whole setup.

Update

When new versions ship, pull them with:

/plugin update superlist-assist@superlist-assist

Commit-SHA versioning during beta means every push is a new version. Update as often as you like.

Open a new Claude Code session

Superlist Assist will run onboarding (one-time setup, about 60 seconds). It asks what areas you want to organize, creates your lists, and gets out of the way.


How it works

  • Built on the official Superlist MCP
  • State lives in ~/.claude/superlist-assist/ — nothing leaves your machine
  • Every task Superlist Assist creates carries a hidden [sb:<id>] marker for idempotency
  • Daily snapshots power the "N of M closed yesterday" line in /brief

Configuration

After install, edit ~/.claude/superlist-assist/config.json to change list names or thresholds. Or use /config interactively.

Default behaviors (all changeable via /config):

  • Morning brief fires at your chosen time each day — if Claude Code isn't open at that time, it surfaces automatically the next time you open it
  • Review surfaces on Mondays if not already run that week
  • A day is flagged "overloaded" at 5 tasks
  • A task is flagged "stuck" after 3 reschedules

Cowork: the SessionStart fallback works in any Cowork session. The scheduled cron trigger fires into the session it was registered from — if you switch to a new Cowork environment, run /config [8] to re-register it.


Layout options

Superlist Assist supports two ways to structure your tasks in Superlist (switch anytime with /config [7]):

One list per area (default) — browse each area separately in the sidebar (e.g. Personal, Work, Health).

Single Brain list — one list with sections and labels per area. Cleaner sidebar, filter by label.


Status

Active development. Commands implemented: /todo, /brief, /recap, /review, /config.

Planned for V2.1: notes and Quick Refs (pending headers support in the Superlist MCP), coaching push-back, personality memory.

About

The quiet layer on top of Superlist that thinks about your tasks so you don't have to.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages