Agenda

The shared configuration behind the agenda addons: one settings note holding the dimensions registry, the profiles, and the searches/filters/sorts/prefixes/colors/groupings/date-rules those profiles reference, plus the Agenda Settings page that edits all of it. It ships no widget of its own — the Overview widget that used to live here is agenda-overview@beatlink, which reads this addon's config and requires it.

The Task widget (start/due dates, duration, recurrence, Complete/Reschedule actions) is a separate addon, agenda-task@beatlink — install it alongside this one for the full Task pane. The two are fully independent: this addon ships none of that addon's code and reads none of its settings, and vice versa. They interoperate only through note-label conventions and the agenda:tasksChanged event. The My Day focus panel is likewise its own addon, agenda-myday@beatlink, and the GTD Organize workflow is agenda-organize@beatlink.

Widgets elsewhere

• Overview — the right-pane widget that re-files the active profile's matching notes under a shared overview note and exports them as an iCal feed is agenda-overview@beatlink. It discovers this addon's #agendaConfig note at runtime and ships its own copy of lib/settings.js and lib/dimensions.js, because Trilium resolves an import only inside the importing note's own subtree.

The Note Actions widget (Zen Mode / Hoist Note quick actions) moved to hoist-note@beatlink, which already owned the hoist toggle.

My Day (the note-detail countdown timer, and the optional loops that append due tasks and send due notifications) moved to agenda-myday@beatlink. It clones this addon's overview/query libraries to resolve which tasks are due from the active profile.

Organize (GTD triage)

The opinionated Collect → Organize workflow (the triage page) is now a separate addon, agenda-organize@beatlink — install it alongside this one for the full GTD flow.

It owns its own settings note (#agendaOrganizeConfig: the Organize-note picker and the quick-times) and its own Organize Editor page, so those tabs are no longer in the Agenda Settings. It reads the dimensions registry back out of this addon's #agendaConfig, because Overview's derived prefix/color/grouping/filter variants come from the same list Organize's triage queues write to — one registry, no drift. Editing that vocabulary still happens here, in the Agenda Settings's Dimensions tab (and is mirrored on Organize's own Dimensions tab).

Templates

The structural templates the Organize workflow used to scaffold with are gone, apart from AreaCollection (an area root), which ships with template-picker@beatlink; nothing provisions a notebook structure any more, so those root notes are yours to create and label. The item templates — Ideas, Goal, Routine, Task, Future, Project, Note — ship with template-picker@beatlink instead (a dependency of this addon), since assigning them is entirely its concern now. Each carries #template (so it is discoverable by Trilium and the Template Picker widget). Template content is yours to customize — every template lives under its owning addon's persistenceRoot, so a future update that changes a default prompts an Update Review rather than overwriting your edits.

Item type is no longer an agenda dimension — it's owned entirely by template-picker@beatlink's own registry, and assigned via its own right-pane widget (a note's ~template relation, not a #type label). agenda-organize@beatlink reads that registry (via its #templatePickerConfig anchor) for two things only: which enabled entries get an Organize bucket, and which entries are marked Actionable — those items flow through the priority/start-date queues. There's nothing to configure on agenda's side; add/rename/reorder/enable templates in template-picker's own settings and Organize reads the change straight away.

Whether a note's Task editor shows at all (if agenda-task@beatlink is installed) is the separate #agendaTaskWidget label, set as an inheritable label on the template note so notes created from it get it automatically.

Priority is just another dimension, shipped by default. Any dimension can additionally mirror the chosen value's colour onto #color. See agenda-organize@beatlink.

Shared configuration

The config lives in one settings note holding a schema.json/defaults.json/config.json set (the dimensions registry, profiles, and the searches/filters/sorts/prefixes/colors/groupings/date-rules those profiles reference). That note is tagged #agendaConfig; every agenda addon finds it at runtime via getAgendaSettings() in lib/settings.js, so a change made in the Agenda Settings page is seen by all of them at once. The prefix/color/grouping/filter variants for each dimension are derived from the registry at read time, so adding a dimension yields all four with no extra setup and they can never drift from the vocabulary.

The three task label names this addon reads — start datetime, due datetime, recurrence — are declared in its own schema.json under Settings. agenda-task@beatlink declares its own copy of that vocabulary in its own #agendaTaskConfig note, and agenda-myday@beatlink does the same. Renaming a label means renaming it in each installed addon that reads it; in exchange none of them reads another's config note or ships another's code.

The Agenda Settings groups its tabs under four workflow categories — Review, Display Elements, Dimensions, Settings — using libsettings@beatlink's category level (_categories + per-field category):

• Review — Overview Note, Active Profile, Profiles, Searches, Filters (what the active profile shows).
• Display Elements — Sorts, Prefixes, Colors, Groupings, Date Rules: the reusable building blocks a profile references by name. Split out of Review because they're a shared library, not per-profile config (Date Rules in particular is the primitive Prefixes/Colors/Groupings/Filters all reference).
• Dimensions — the classification vocabulary registry (area, priority, any you add). This addon owns it; agenda-organize@beatlink reads and mirrors the same registry on its own Dimensions tab. Item type lives in template-picker@beatlink's own settings instead, not here.
• Settings — the three task label names this addon reads: start datetime, due datetime and recurrence. The rest of the task vocabulary (the split date/time labels, duration) and the Task pane's Reschedule Options are edited on agenda-task@beatlink's own Task Settings page, reachable from TAM's "Addon Settings" button.

Config migrations

Adding a new default dimension/sort/colour/etc. reaches existing installs for free — a registry's entries in defaults.json are its shipped entry set, reconciled into every install on read/write, so no migration is needed for additive changes. Reshaping data the user already owns (renaming a stored key, moving a value between fields, dropping a field) is what lib/migrate.js handles: an ordered list of one-time transforms of the raw persisted config, gated by a #agendaConfigVersion label on the #agendaConfig note so each step runs exactly once per install. getAgendaSettings() runs any pending steps before the first read, so every widget sees migrated config. The shipped list is empty (nothing to reshape yet); adding a step is push-one-entry + bump the version.

Task edits (if agenda-task@beatlink is installed) broadcast an agenda:tasksChanged event via Trilium's api.triggerEvent/useTriliumEvent; agenda-overview@beatlink subscribes and re-files the overview note live.

Upgrading from 7.x

Version 8.0.0 finishes the split started in 4.0.0: this addon no longer references agenda-task@beatlink in any way. Three things change.

• The Agenda Settings's Settings category now holds this addon's own three label fields (start datetime, due datetime, recurrence) instead of agenda-task's panels. If you had renamed any label, re-enter the new names here once — this addon previously read them out of a config key that no longer existed, so it was matching on undefined and the Start/Due columns, iCal feed and due notifications were silently doing nothing. The full label vocabulary and Reschedule Options keep living on agenda-task's own Task Settings page.
• The Overview's Start All Tasks Today button is gone. It was the last caller of agenda-task's reschedule library; per-task reschedule buttons in the Task pane are unaffected.
• The overview no longer backfills the durationDisplay/recurrenceDisplay labels on every refile. The two columns stay, populated by agenda-task itself on every task edit; a task never opened in the Task pane since installing shows them blank until it is.

Upgrading from 3.x

Version 4.0.0 splits the Task widget out into its own addon, agenda-task@beatlink, with its own #agendaTaskConfig settings note. Install agenda-task@beatlink to keep the Task pane — this addon no longer ships it. An existing install's label-name overrides and Reschedule Options are copied automatically into the new settings note on agenda-task@beatlink's first read after both addons are updated; no manual migration step is needed.

Upgrading from 2.x

Version 3.0.0 removes the type dimension entirely and requires template-picker@beatlink as a dependency. Item classification is now purely a note's ~template relation; agenda no longer writes #type. The seven item templates (Ideas/Goal/Routine/Task/Future/Project/Note) moved out of agenda's own manifest into template-picker's — if you already have agenda installed, run template-picker@beatlink/migrate-templates-from-agenda.js once, manually, before updating, or TAM's next sync will delete your existing (possibly customized) template notes and recreate blank ones under template-picker instead. See that script's own header comment for exact steps. Notes that only ever carried #type (never ~template) aren't automatically migrated — they'll surface in template-picker's Missing Templates page for manual re-triage.

Layout

Sources are grouped by kind, and note titles match the file names:

Folder	Holds
ui/	Settings.jsx (the Agenda Settings page), settings.css
lib/	settings.js — getAgendaSettings(), the reader every agenda addon uses; dimensions.js; migrate.js
config/	schema.json, defaults.json
static/	calendar.ical — the seed body of the iCal feed note the Overview widget writes

lib/settings.js and lib/dimensions.js are also pulled by agenda-overview@beatlink and agenda-organize@beatlink through relative sourceUrls, so each install carries its own copy of the reader while the data stays in this addon's one config note.

Trilium resolves an import / require by note title within the importer's subtree, not by path, so the folders are a repo-side convention only.