Skip to content

Releases: marginalreader/role-focus

Release list

v1.0.0 — First public release

v1.0.0 — First public release Latest
Latest

Choose a tag to compare

View all tags
@marginalreader marginalreader released this 18 May 03:33
v1.0.0
1b34d75

Role Focus — v1.0.0 Release Notes

First public release · May 18, 2026

Plugin ID: marginalreader.RoleFocus
Author: marginalreader
Minimum NotePlan version: 3.3.2
Repository: https://github.com/marginalreader/role-focus

Overview

Role Focus is a NotePlan plugin for productivity systems organized around personal roles. It docks an interactive panel inside NotePlan that pulls every open task belonging to a role — whether it lives in the role's folder or just mentions @rolename in a daily note — into one focused view for browsing, triaging, and acting on.

This is the first stable, publicly-distributed release.

What's in 1.0

Role Focus tab

  • Auto-detected roles from the subfolders of a configurable Roles folder. Numbered folders (01 Husband) display cleanly (Husband) and match cleanly (@husband).
  • Unified task list drawn from both the role's folder and any note (project or daily) containing the role's @mention. Deduplicated.
  • Role pills with live task counts, collapsible to a single label.
  • Resizable project panel showing every note in the role's folder with task-count badges. Click to filter the task list to one project; ⌘-click for multi-select. Collapses to a dropdown on narrow screens.
  • Live text filter scoped to the current role.
  • Date sort (ascending / descending / off) over explicit >YYYY-MM-DD markup and the implicit date of daily notes.
  • Flags-on-top toggle floats ! -prefixed tasks to the top while date sort still applies within each group. Persists across sessions.
  • Filters dropdown with Hide Tags and Hide Future (configurable day threshold inline).
  • Overdue highlighting including tasks due today, with configurable color.
  • Sub-content capture for paragraphs indented under tasks, hidden behind an expand arrow.
  • Clickable links in sub-content for http(s)://, noteplan://, omnifocus://, and things://.

Flagged tab

  • Cross-role hit-list of every flagged (! …) task across every role.
  • Future-scheduled tasks excluded — undated and past-due flagged tasks shown so the list is always actionable today.
  • Role and project label on each row instead of the source-note name.
  • One-click unflag — the ⚑ button removes the task from the list and from the source note.
  • Lazy-loaded and automatically invalidated when a flag is toggled elsewhere.

Missing Roles tab

  • Unassigned-task inbox scans daily/calendar notes for open tasks with no @role mention.
  • 30 Days / All Time lookback toggle.
  • Inline role assignment via dropdown of all detected roles; the mention is written back to the source note and the row fades from the list.

Per-task actions

  • Mark complete with optional @done(YYYY-MM-DD HH:MM AM/PM) stamp.
  • Single-click task text to open the source note at the exact line.
  • Double-click to inline edit; Enter saves, Escape reverts.
  • Add a #tag without leaving the panel.
  • Add an @rolename mention without leaving the panel.
  • Flag toggle (prepend/strip ! ).
  • Clear button strips configurable subsets of @/#/> tokens.

Add Task modal

  • Notes from nested subfolders included (Subfolder / Note display).
  • Single Actions notes pinned to the top.
  • Two-step location picker: section (Top / Bottom / heading) → position (Top / Bottom of section, when a heading is chosen).
  • Pre-selects the destination note when exactly one project is active in the project panel.

Design and platform

  • Docked inside NotePlan's main window.
  • Full dark mode support.
  • Mobile-friendly touch targets; layout adapts at viewport widths below 600px.

Settings

Setting Default Description
rolesFolder Roles Root folder containing your role subfolders.
defaultLookbackDays 30 Days back to scan in the Missing Roles tab. 0 = all time.
showSubContentByDefault false Expand sub-content by default.
clearRoles true Clear button strips @role mentions.
clearTags false Clear button strips #tags.
clearDates false Clear button strips >dates.
overdueColor #FF3B30 Hex color for overdue highlighting.
hideTags ["waiting"] Tags hidden by the Hide Tags filter (comma-separated, no #).
appendCompletionDate true Append @done(...) on completion.
hideFutureDays 7 Day threshold for the Hide Future filter.

Commands

Command Aliases Opens
/role focus rf, focus Role Focus tab
/missing roles triage, unassigned Missing Roles tab
/rf debug rfdebug Diagnostic logging

Upgrading from a pre-release (0.x) install

If you have been running an internal 0.x build, please:

  1. Quit NotePlan.
  2. Remove the old plugin folder (e.g. role-focus/ or wookjeezy.RoleFocus/).
  3. Install the new folder named exactly marginalreader.RoleFocus.
  4. Reopen NotePlan.

Settings keys are unchanged from 0.9.0, so your existing configuration carries over. The lastInstalledVersion preference will be set on first load.

Known limitations

  • The plugin only scans direct subfolders of the Roles folder for role detection — nested role hierarchies are not supported.
  • Implicit dates from daily notes apply only to tasks in calendar notes; project-note tasks without explicit >date markup remain undated.

Acknowledgments

Built with NotePlan's plugin API. Developed by marginalreader.

Assets 5
Loading