Agenda Tasks

A comprehensive task management and calendar plugin for Obsidian

🆕 What's New in v1.1.15 — Calendar and habits: weekends and holidays (Mexico, United States and a new International calendar of UN days) are shaded in the calendar, recurring tasks are projected as ghost pills, and your habits show up in the calendar as a daily chip. Habits can have an active period and vacations, and the Habit Tracker views are picked with round icon buttons. See details · Full changelog.

Overview

Agenda Tasks transforms your Obsidian vault into a powerful productivity system by providing intuitive task management interfaces and multiple calendar views. Seamlessly integrate with your existing Obsidian notes while organizing tasks across multiple views for maximum efficiency.

Key Benefits:

• 🎯 Multiple view types tailored to different workflows
• 🔄 Real-time synchronization with your notes
• 🏗️ Compatible with Obsidian Tasks plugin
• 🌐 Support for 6+ languages
• ⚙️ Highly customizable interface

📖 Table of Contents

• News
• Features
• Screenshots
• Installation
• Quick Start
• User Manual (English · Español)
• Gestures & Interactions
• Task Format
• Configuration
• Changelog
• Planned Features
• Support
• Contributing

🆕 News

v1.1.15 (latest)

• Non-working days and shading: a new setting with one checkbox per weekday (Saturday and Sunday by default) decides which days are non-working. They are shaded in the calendar's Month, Week, List and Day views and in the Gantt, and hidden in Work Week; the habit frequencies "Weekend" and "Work week" and the recurrences every weekend and every weekday follow it
• Holiday calendars: add calendars of public holidays for Mexico and the United States (with optional states), official and/or unofficial, each with its own color. Holidays show their name as a tinted label in every calendar view (a dot in Year, a tinted column in the Gantt), and a day with an official holiday is shaded like a non-working day. Unofficial days (Mother's Day, Halloween…) keep their label but do not shade the day
• International days: a new International holiday calendar with 58 days of the UN and other international bodies in four topics — Women and children, Health, Environment and Society and rights — that you tick in the settings
• Projected recurring tasks: recurring tasks (🔁) appear in the calendar ahead of time as read-only, outline-only pills (10 occurrences by default, 0 to 50 in the settings); clicking one opens the real task, and completing the real task writes the next occurrence as usual
• More from the calendar filter bar: Start date, Scheduled date and Due date in + Filter choose which date pills are drawn, and the Recurring tasks, Habits and Holidays items (ticked by default) hide projected tasks, habit chips and holidays. The pill's left margin now takes the color of the task's area, and pills are slimmer
• Habits in the calendar: each day shows a chip with the habits done out of those due (for example 🌅 2/4); click it to tick habits and open their notes without leaving the calendar. It follows the area filter and the search, and a vacation day adds a 🌴
• Habit active period and vacations: a habit can have Active from / Active until dates, and vacation periods (Settings ▸ Habits, or the 🌴 button in the toolbar) apply to all habits: a vacation day you did not tick neither breaks a streak nor lowers a percentage
• Habit Tracker toolbar: the five views are picked with round icon buttons, and Sort and Group are chips like the ones in the task views

v1.1.14

• Lanes: a new Lanes button in the filter bar splits a view into independent widgets, one per value of a field — Area, Sub-area, Status, Priority, Tag, Folder or File (the default, None, shows the view as before). In Kanban each lane is its own board with the same columns, so you finally get one board per area; in List each lane is a section; in Table each lane is its own block with the column header repeated and the same widths in every lane; in the Gantt each lane is its own chart over one shared window and zoom, with the date header repeated. Fold a lane with its ▼ (remembered); empty lanes are hidden, Root and No tag go last, and area lanes carry the area color. By Tag a task appears in each of its tags. Lanes are read-only: you cannot drag a card to another lane
• Group and Sort as buttons: the old dropdowns became compact buttons placed next to + Filter with the same look; clicking one opens the same menu as + Filter with the current choice checked, and the Sort button has an arrow to reverse the direction. The List | Table switch moved next to the search box. The group labels are shorter (None, Area and sub)
• Lanes and Group never repeat a field: if you pick for one the field the other uses, Kanban does not allow it (its columns are required) and List, Table and Gantt switch the other button to None for you. Area, Sub-area and Folder count as the same field
• Filters with several values: Priority, Status and Area (with its sub-areas) accept several values at once. A small checklist stays open while you tick values; it closes when you click outside or press Esc. Values of one type are combined with or (Normal or Medium) and different types with and; for areas the most specific choice wins. A filter with several values shows only its count (for example Status: 2) and a tooltip lists them, so the chips stay small
• Filters in the calendar: the six calendar views (Day, Week, Work Week, Month, Year and List) show the same filter bar with search, Priority, Status and Area, remembered on its own. Typing in the search box keeps its focus while the calendar updates
• Group by start and scheduled date: List and Table can now group by Start date and Scheduled date (by day, like Due date; tasks without the date go last)
• Gantt Group: the Gantt gets a Group selector with None (a flat list without headers), Area (default), Status and Priority. Tasks without a date stay in one list at the end, shared by all lanes

v1.1.13

• Kanban tab: your tasks as a board. Columns by Status (default), Priority, Tags or Folder, with the shared filter bar (search, filters, sort) and its own remembered settings. Drag a card to another status column to change its status (moving it to Done adds ✅ and completing a recurring task creates its next occurrence) or to another priority column to change its priority. Click edits, double-click opens the note and right-click changes the status
• Collapsible columns: click a column header to fold it into a thin bar with its name and task count (empty columns start folded). A folded column still accepts a dropped card and opens by itself; tall columns scroll on their own with a fixed header
• Gantt tab: one row per task on a time axis, grouped by area and sub-area. Zoom to 7, 14 or 21 days or a calendar month, with month tabs, year arrows, week bands, a thin vertical day grid with weekends shaded and a line for today. A task with two or more of 🛫, ⏳ and 📅 is a bar, one with a single date is a milestone, and the rest wait in a collapsible "Tasks without a date" group below. Hover a bar to see all its dates; 🔗 marks tasks with dependencies. Status and priority show next to each name
• Edit dates from the Gantt: drag a bar to move all its dates, drag an edge to rewrite only the field that edge shows (start, scheduled or due), or stretch a milestone into a bar. A tooltip shows what will be written, a bar can never end before it starts, and the 🆔/⛔ links and the creation and done dates are left alone
• Simpler tab settings: one Show Tasks tab switch replaces the List and Table ones, Show Habits tab hides the whole Habits tab, and there are new Show Kanban tab and Show Gantt tab switches
• What's new window: after an update, a window shows the news once, translated to your language (turn it off in Settings ▸ Show what's new after an update)
• Habits folder: if the folder does not exist, creating your first habit offers to create it (with an editable path), Settings tells you whether it exists, and every habit view shows a clear message instead of an error when there are no habits
• Filters and labels: the Area filter has a Root option for notes outside any folder and the Sub-area filter has one for notes directly in an area's folder. Group and sort selectors now read "Group:" and "Sort:", and the habit sort options lost their "By" prefix
• Fix: the Week, Work Week and List calendar views showed shifted weekday names when the week did not start on Sunday. Thanks to @AidanAJoyce (#58)
• The README now links to the user manual, in English and Spanish

v1.1.12

• One "Tasks" tab: the List and Table views share a tab with a List | Table switch. Search, filters, grouping and sort order are shared and remembered, so switching mode (or coming back from editing a task) keeps what you were looking at
• Areas and sub-areas: a task's area is the first folder of its note and its sub-area is the rest of the folder path (any depth); notes in the vault root are "No area". Use them to filter and to group (nested sub-areas, colored group headers); tasks sitting directly in an area's folder are listed last under "No sub-area"
• New filter bar: a + Filter button opens step-by-step menus (type, then value) for Priority, Status, Area (with sub-area), Start, Scheduled and Due. Active filters appear as removable chips with a Clear button; search sits on the right and drops to its own line on narrow windows
• Grouping in List and Table: No grouping, Area and sub-area, Folder (flat), Status, Priority, Tags or Due date, with collapsible groups. This replaces the old hierarchical/flat button
• Table dates: the single Dates column became four — Start (with the creation date below), Scheduled (with time and duration), Due and Closed (done or cancelled). A date column is hidden when no loaded task has that date. The Folder column is now Area, row numbers are gone and columns fit the available width, even on phones and tablets
• Date filters per type: Due, Start and Scheduled each filter by With date, Overdue/Past, Today, Next 7 days, Future or No date. "Overdue" now counts only open tasks, and sorting works on all four date columns (also in the List)
• List: each task shows its start (🛫), scheduled (⏳, with time) and due (📅) dates, and right-clicking a task in the List or Table opens the status menu, like in the calendar
• Automatic refresh: List, Table, Calendar and Habit views update on their own about half a second after a real change in your notes (saving a note without touching tasks does nothing), keeping scroll, filters and collapsed groups, and waiting while a modal, menu, drag or text field is in use. At midnight the views switch to the new day without any interaction
• Safer edits: before changing a task line the plugin checks it still matches what the view showed; if the note changed in the meantime it finds the exact line or cancels with a notice instead of editing another task

v1.1.11

• Android phone and tablet layout fixes: Obsidian's mobile styles were distorting several controls. Fixed the calendar view-type buttons (their icons were invisible), the date picker (clipped on the right), the Day view sidebar toggle, the Habit Routine completion circle (oval), Habit Grid and Weekly cells (rectangular cells, shifted and cut streak pills), and buttons in the Task Modal, the Habit Editor and the Table
• Habit Routine on narrow screens: habit names are visible again, long area tags no longer overflow their pill, and clicking a habit name opens the Habit Editor (double-click opens its note), like Grid, Weekly and List; the hover-only action buttons are hidden on touch devices
• Dark themes: header tab labels and icons are readable without hovering
• Calendar List view: each row shows the month abbreviation, so a window that crosses a month boundary stays clear
• Table: the File column was removed, and the row-number and date columns are narrower to reduce horizontal scrolling
• The List view descriptions in this README and the user guide now match what the view does
• Updated dependencies (including a security fix in Handlebars) and fixed new lint findings

v1.1.10

• New List view inside the calendar: one row per day in a continuous, configurable 7–14 day window (default 14, Settings ▸ Calendar), reusing the same task pills as Month/Week — no "N more" collapsing
• Day view now supports a 1/3/5-day mode, with the reference day centered and its own hour grid, duration blocks and lanes per column; dragging a task to another column reschedules it to that day
• Task status management from the calendar: a new "On Hold" status, a status icon on every calendar task pill, and a right-click context menu (or a Task Modal field) to change a task's status — marking "Done" adds the completion date, same as the native checkbox
• Recurring tasks (🔁): completing a recurring task now inserts its next occurrence right above, computed with the rrule library and respecting when done
• Unified date picker in the Task Modal: the due/start/scheduled fields now open the same calendar popover used across calendar views, with a dot marking days that already have tasks
• Duration modal now uses a circular time dial (shared with the Habit Editor) instead of a plain number input, up to 7 hours in 5-minute steps
• Recurrence field in the Task Modal now offers autocomplete with recognized patterns (including when done variants)
• Fixed: task-filter.ts compared a task's status symbol against status text, so completed/cancelled tasks were never excluded as expected

v1.1.9

• Day view now renders tasks with their real duration: connected blocks for 60+ minute tasks, half-cell blocks for shorter ones, and side-by-side lanes so overlapping tasks never cover each other
• Resize a task's duration directly from the Day view by dragging its bottom edge, snapping to 30-minute steps
• Dragging a task to a new time slot in the Day view now snaps to the exact half-hour under the pointer
• A shared reference date is kept when switching between calendar view types, with a new date picker (popover in Month/Week/Work Week/Year, always visible in Day) to jump to any date
• The calendar view-type switcher is now a compact row of icon buttons instead of a dropdown
• Double-click to create a task directly in the Day view's hour grid or "All day" section
• Click a day cell in Month/Week/Work Week/Year to select and highlight it as the reference date, without interfering with the double-click-to-create gesture
• Fixed the Work Week view's task click gesture to match the rest of the calendar (click edits, double-click opens the note)

v1.1.8

• Refreshed the List view with compact task rows, clearer folder hierarchy, priority cues, and improved selection feedback
• Refreshed the Table view with clearer filters, denser rows, visible status/priority cues, and compact date/tag styling
• Table search, filters and sort order are remembered when returning from task editing or switching views; column widths adapt to the filtered rows
• Sortable Table headers support mouse and keyboard interaction
• Added consistent themed tooltips across plugin views and task modals, with clearer Dashboard metric/list descriptions in all six supported languages

v1.1.7

• Fixed Habit Tracker startup after plugin updates: views wait for the initial habit cache to finish loading after saved settings are available
• Fixed habit edits that could duplicate the YAML frontmatter block; the editor now performs one write and normalizes affected notes when they are edited again
• Dashboard area/daytime percentages now count completed occurrences individually, so a completed morning occurrence counts while an afternoon occurrence remains pending
• Grid and Weekly show a consistent daytime badge beside every multi-daytime row; a setting (on by default) controls the badge for single-daytime habits
• Grid and Weekly remember their last selected sort order; the Habit List status column is sortable
• Routine groups can be collapsed independently, and each group's collapsed state is remembered
• Habit names use consistent gestures: single-click opens the Habit Editor and double-click opens the note in Grid, Weekly and List
• Known area names such as daily plan are normalized to their palette key (daily-plan) when resolving area colors

v1.1.6

• Fixed habit edits that could duplicate the YAML frontmatter block; the editor now performs one atomic write and normalizes affected notes when they are edited again
• Habit Grid, Weekly and List views now use consistent gestures: single click opens the Habit Editor and double-click opens the habit note

v1.1.5

• Fixed a race condition where editing a habit could save the file correctly but leave old values in the Habit Tracker views until a later refresh. The cache now parses frontmatter from the file content it just read.

v1.1.4

• Time-of-day scheduling: the ⏳ scheduled date can now carry a 🕐 time and, for block-mode tasks, a ⏱️ duration — fully optional and additive, existing tasks are unaffected. due stays a whole-day field
• Insert or edit task fields from the editor, no need to open a modal: a right-click context menu and a command (with keyboard shortcut) work on any task line, using a native date picker and a new iOS-style scroll wheel for the time
• Calendar views (Month/Week/Work Week/Day) can now show start and scheduled dates alongside due, each with its own icon + color badge — configurable in Settings ▸ Calendar; completed tasks are dimmed by default, with an option to hide them entirely
• Day view now has a real hourly grid populated from scheduled times, plus a collapsible "All day" section for due/start
• Drag and drop a task in any calendar view to reschedule it: drag to another day in Month/Week/Work Week, or to another hour in Day view
• Click a task in the calendar to edit it in a prefilled modal — double-click still opens the underlying note
• Task creation modal redesigned: scheduled date is now the default field, priority is a one-click segmented selector, and a collapsible "More fields" section holds start date, due date, recurrence, dependencies, on-completion behavior and a custom ID

See the full changelog below for older versions.

✨ Features

📊 Available Views

Overview View

• Dashboard-style task summary with key metrics
• Statistics and progress tracking
• Quick access to upcoming deadlines
• Task distribution by project/folder
• Overdue task highlighting
• Customizable widgets

List View

• Compact task rows with priority cues, plus start, scheduled and due dates when a task has them
• Shares the Tasks tab with the Table view (List | Table switch, next to the search box)
• Search, filter chips (Priority, Status, Area, Start, Scheduled, Due), grouping and sort order; Priority, Status and Area accept several values
• Group by area and sub-area (nested), folder, status, priority, tags, due date, start date or scheduled date; collapsible groups
• Lanes (new in 1.1.14): one collapsible section per area, sub-area, status, priority, tag, folder or file
• Click a task to edit it in the task modal; double-click to open its note; right-click to change its status

Table View

• Spreadsheet-style task management, in the same Tasks tab and with the same filter bar as the List view
• Start, Scheduled, Due and Closed date columns (hidden when no task has that date)
• Sortable and resizable columns that fit the available width
• Grouping with collapsible group headers
• Lanes (new in 1.1.14): each lane is its own block with the column header repeated, the same columns and widths in every lane, and a gap between lanes
• Quick entry and editing of task attributes
• Conditional formatting

Calendar View

• Multiple calendar layouts (day, week, work week, month, year, and list)
• Filter bar (new in 1.1.14): search, Priority, Status and Area filters in all six layouts
• Holidays and non-working days (new in 1.1.15): weekends and days with an official holiday are shaded; holiday calendars for Mexico, the United States and International UN days, each with its own color
• Projected recurring tasks (new in 1.1.15): future occurrences of recurring tasks as read-only ghost pills, hideable from the filter bar
• Habits in the calendar (new in 1.1.15): a daily chip with the habits done out of those due, with a list to tick them
• Filter bar items (new in 1.1.15): choose which date pills to draw (Start, Scheduled, Due) and show or hide Recurring tasks, Habits and Holidays
• Day view supports a 1/3/5-day mode with the reference day centered
• List view shows a continuous, configurable 7–14 day window, one row per day
• Task visualization on calendar grid
• Mini-calendar for quick date navigation
• Task indicators showing busy days
• Quick task creation at specific times
• Syncs with native Obsidian daily notes

Kanban View (new in 1.1.13)

• Board of real tasks: moving a card rewrites the task line in its note
• Columns by status (default), priority, tags or folder; the same search, filters and sort order as the Tasks tab, saved separately
• Drag a card to another status column to change its status, or to another priority column to change its priority (tags and folders are read-only)
• Collapsible columns that remember your choice, with empty ones folded by default
• Lanes (new in 1.1.14): one board per area, sub-area, status, priority, tag, folder or file, each with its own columns; cards cannot be dragged between lanes
• Click a card to edit it, double-click to open its note, right-click to change its status

Gantt View (new in 1.1.13)

• One row per task on a time axis, grouped by area and sub-area (collapsible), with a vertical day grid and weekends shaded
• Group (new in 1.1.14): None (flat list), Area (default), Status or Priority
• Lanes (new in 1.1.14): one chart per lane over a shared window and zoom, with the date header repeated in each lane
• Zoom 7, 14 or 21 days or a calendar month; month tabs, year arrows and a line for today
• Bars from start to due (with a notch for the scheduled date), milestones for tasks with a single date, and a collapsible list of tasks without a date
• Move bars, drag their edges to change a single date, or stretch a milestone into a bar; a tooltip shows exactly what will be written
• Same search, filters and gestures as the other task views

Habit Tracker (new in 1.1.0)

• Habit Grid - GitHub-style day-by-day grid with a merged streak "pill", per-occurrence rows for multi-daytime habits, and a configurable sort order
• Daily Routine - Today's habits grouped by daytime or by area (toggle), with weighted progress bars and quick actions to open the note or edit the habit
• Habit Dashboard - Today's raw/weighted completion, current and best streaks, side-by-side breakdowns by area and daytime, a 30-day history chart, and a GitHub-style yearly heatmap you can navigate by year (this is now the default habit view)
• Weekly view - 7-day matrix sharing the same visual language as the Grid (pills, circles, sorting)
• Habit Table/List - Sortable catalog of all habits with area, related-file link, frequency, priority, daytime, time and streak columns
• Habit Creator - A modal to create and edit habits: a circular time dial, priority/max-gap sliders, an active/inactive switch, optional Active from / Active until dates (new in 1.1.15), and an area combobox suggested from your vault's root folders (free-form, not a fixed list)
• Vacations (new in 1.1.15) - Global vacation periods that apply to all habits: an untouched vacation day is neutral for streaks and percentages
• Round view buttons (new in 1.1.15) - The five views are picked with round icon buttons, and Sort and Group are chips like in the task views

🔧 General Capabilities

• ✅ Parse and track tasks from your entire vault
• ✅ Compatible with Obsidian Tasks syntax
• ✅ Real-time task updates, with views that refresh by themselves
• ✅ Areas and sub-areas derived from your folder structure
• ✅ Kanban board and Gantt chart that edit your tasks in place
• ✅ Lanes: split Kanban, List, Table and Gantt into independent widgets by area, status, priority, tag, folder or file
• ✅ Filters with several values, in the task views and in the calendar
• ✅ A "what's new" window after each update, in your language
• ✅ Built-in Habit Tracker module (Grid, Routine, Dashboard, Weekly and Table views, plus a habit creator/editor)
• ✅ Customizable interface with themes support
• ✅ Keyboard shortcuts for common actions
• ✅ 6+ language support (English, Spanish, German, Portuguese, French, Italian)

📸 Screenshots

View	Screenshot
Overview Dashboard
List View
Table View
Month Calendar
Week Calendar
Day View
Kanban View
Gantt View

View	Screenshot
Habit Dashboard
Daily Routine
Habit Grid
Habit List

📥 Installation

From Obsidian Community Plugins (Recommended)

1. Open Obsidian Settings
2. Navigate to Community Plugins and disable Safe Mode
3. Click Browse and search for "Agenda"
4. Click Install and then Enable

Manual Installation

1. Download the latest release from the releases page
2. Extract the zip file to your vault's .obsidian/plugins/obsidian-agenda/ folder
3. Verify the following files are present:
   • main.js
   • styles.css
   • manifest.json
4. Enable the plugin in Obsidian Settings → Community Plugins

Requirements:

• Obsidian v0.13.0 or higher
• No additional dependencies required

🚀 Quick Start

Creating Your First Agenda View

1. Click the Agenda icon in the left sidebar ribbon
2. Select your preferred view type:
   • Overview - Dashboard with key metrics
   • List / Table - One "Tasks" tab with a List | Table switch
   • Calendar - Calendar visualization
3. Your tasks will automatically populate from your vault

Common Actions

• Filter tasks - Click + Filter (List and Table views) and pick a type and a value
• Create task - Use Ctrl+P or the create button
• Edit task - Click any task to edit inline or in modal
• Sort tasks - Use the sort selector, or click column headers (Table view)

For step-by-step guides, read the User Manual (English · Español) or visit the Wiki.

🖱️ Gestures & Interactions

A quick reference of clicks, double-clicks and drags across the plugin — handy while you're getting familiar with it.

📅 Calendar Views (Day / Week / Work Week / Month / Year / List)

📋 List, Table & Overview

Search, filters, lanes, grouping and sort order are shared by the List and Table views and remembered when you return from editing a task or switch views. Column widths adapt to the rows visible after filtering.

🗂️ Kanban

📊 Gantt

🔥 Habit Tracker

📝 Task Format and Compatibility

Agenda Tasks works seamlessly with tasks created using the standard Obsidian checkbox format (- [ ]) and is fully compatible with the popular Obsidian Tasks plugin.

Supported Metadata

The plugin recognizes and properly handles all standard Obsidian Tasks metadata, plus its own time-of-day extensions (v1.1.4):

⏰ Scheduled time/duration and the fields above are recognized anywhere on the line, in any order — they don't need to be adjacent or in a specific sequence.

Example Task

- [ ] Complete project documentation 📅 2024-12-31 ⏫ #project #documentation
- [ ] Review pull requests ⏳ 2024-06-15 #code-review
- [ ] Team standup ⏳ 2024-06-16 🕐 09:00 ⏱️ 15m 🔁 every weekday
- [x] Submit final report 🛫 2024-06-01 ✅

⚙️ Configuration

View Settings

• Tab Visibility - Choose which tabs to display in the header: Overview, Tasks, Kanban, Gantt, Calendar and Habits (plus each Habit Tracker view)
• Default View - Set your preferred view on plugin load
• Theme Integration - Customize colors and appearance

Calendar Settings (new in 1.1.4)

• Show Due/Start/Scheduled Dates - Independently choose which date types appear on calendar views, each with its own icon + color badge
• Show Completed Tasks - Keep completed tasks dimmed on the calendar, or hide them entirely
• List View: Days to Show (new in 1.1.10) - Number of days shown in the calendar's List view window (7–14, default 14)
• Projected recurring tasks (new in 1.1.15) - Future occurrences of each recurring task (0 to 50, default 10) drawn as faded, read-only copies in the Month, Week, Work Week, Day and List views
• Non-working days (new in 1.1.15) - One checkbox per weekday (Saturday and Sunday by default)
• Holiday calendars (new in 1.1.15) - A list of calendars (none active by default), each with a country (Mexico, United States or International), an optional region, official/unofficial checkboxes (or topic checkboxes for International) and a color

Filtering & Sorting

• Type filters (+ Filter; List, Table, Kanban, Gantt and the Calendar views) - Priority, Status and Area (with sub-area) accept several values at once; Start, Scheduled and Due (not in the Calendar) take one; Area and Sub-area also offer Root
• Date filters - Each of Start, Scheduled and Due: With date, Overdue/Past, Today, Next 7 days, Future or No date ("Overdue" counts only open tasks)
• Search - Free text over the task description
• Lanes (Kanban, List, Table and Gantt) - None, Area, Sub-area, Status, Priority, Tag, Folder or File
• Grouping - List and Table: None, Area and sub, Folder, Status, Priority, Tags, Due date, Start date or Scheduled date; Kanban: Status, Priority, Tags or Folder (the columns); Gantt: None, Area, Status or Priority
• Sorting - Priority, Status, Task, Area, Start, Scheduled, Due, Closed or Tags (ascending or descending)

Advanced Options

• Keyboard Shortcuts - Customize shortcuts for common actions, including inserting a task field from the editor without opening a modal
• Widget Configuration - Personalize dashboard widgets
• Display Preferences - Adjust how tasks are displayed
• Show what's new after an update - Opens a window with the news the first time you start Obsidian after updating (on by default)
• Task Modal mode - The "More fields" (advanced) section of the Create/Edit Task modal remembers whether you left it expanded or collapsed, per device

Habit Tracker Settings

• Habit Folder Path - Vault folder scanned (recursively) for habit notes
• Days to Show - Number of columns/days rendered in the Grid and history charts
• Show Streaks - Toggle streak indicators and counts
• Show daytime for single-daytime habits - Show a small localized daytime badge beside the habit name in Grid and Weekly (on by default; multi-daytime rows always show the badge)
• Default Max Gap - Default tolerance (in days) before a streak breaks
• Tab Visibility - Show/hide each habit view (Grid, Routine, Dashboard, Weekly, Table) independently
• Vacations (new in 1.1.15) - A list of vacation periods (start, end and an optional name) that apply to all habits

Access settings via: Obsidian Settings → Community Plugins → Agenda Tasks. The panel is split into three tabs: General, Calendar and Habits

📋 Changelog

Version 1.1.15 📆

• Non-working days (non-working-days.ts): the new setting nonWorkingDays (ISO weekdays, default Saturday and Sunday) replaces the fixed weekday >= 6 of the Gantt and is shared by the calendar shading, the Work Week view, the habit frequencies "Weekend" and "Work week" and the recurrences every weekend and every weekday. The settings screen is split into General, Calendar and Habits tabs
• Holiday engine (src/core/holidays/): embedded, offline rules (fixed date, nth or last weekday, relative to Easter, observed, six-year cycle and explicit lists) for Mexico and the United States with their regions, plus an International calendar whose rules belong to topics (group) that the calendar ticks (groups). HolidayLookup answers per day; sanitizeHolidayCalendars() cleans the saved setting and changeHolidayCountry() resets what depends on the country. hasOfficialHoliday() decides the shading: only official holidays shade the day (also the Gantt tint), unofficial ones keep their label
• Projection (task-projection.ts): projectOccurrences() chains getNextOccurrenceDate() to draw up to N (calendarProjectionCount, 0 to 50) read-only ghost pills per recurring task; when done rules are not projected
• Calendar filter bar (calendar-state.ts, task-filter-bar.ts): date types, Recurring tasks (projected), Habits (habits) and Holidays (holidays) as one-click items, saved with the calendar state; the pill's left margin takes the area color
• Habits in the calendar (habit-calendar.ts): buildHabitDaySummary() and filterHabitsForCalendar() feed a per-day chip and a popover that toggles occurrences through HabitManager; the holiday label and the chip share a wrapping row
• Habits (habit-calendar.ts, habit-view-icons.ts): from/until active period and global vacation periods with one counting rule, countsOn(), used by cells, streaks and statistics; round icon buttons for the sub-views and Sort/Group chips
• Tests: new Node tests for the non-working days, the holiday rules and calendars, the projection, the calendar filters, the shading, the habit day summary and the habits in the calendar (node --test "tests/*.test.cjs")
• Documentation: the user manual (English and Spanish) covers the shading, holidays, the International calendar, the projected tasks, the filter-bar items and the habits in the calendar. International dates are written from memory and are worth a review

Version 1.1.14 🛤️

• Several values per filter (task-view-state.ts, area.ts, task-filter-chips.ts): TaskViewState.priority and status became lists and the area and sub-area became one list of routes (Work, Work/Proj, Work/ for notes directly in the folder, / for the vault root); an empty list means "all". OR inside a type, AND across types, and the most specific area route wins. A saved state in the old format is converted when read. A checkbox popover (task-filter-popover.ts) stays open while you tick values; a chip with several values shows only its count and a tooltip lists them
• Calendar filters (calendar-state.ts, calendar-view.ts): one saved state shared by the six calendar views, filtered in a single place (getTasksForDate()); the bar is the first element of the content container and only the calendar body is redrawn when filtering, so the search box keeps its focus
• Chip bar (task-filter-bar.ts, task-axis-chips.ts): the Group and Sort selects became chips that open a native menu, placed next to + Filter; the pure model decides what each chip shows, which options are in use and what changes when one is picked. The List | Table switch moved next to the search box
• Lanes (task-lanes.ts): buildLanes() splits already filtered and sorted tasks by area, sub-area, status, priority, tag, folder or file (natural order for status and priority, alphabetical for the rest, Root and No tag last, a task repeated in each of its tags). resolveAxisConflict() keeps Lanes and Group from sharing a field (by family: status, priority, tag, file and the path family area/sub-area/folder); repairAxes() fixes a saved clash when a view opens. List: a section per lane; Table: one <table> with a title row per lane, the header repeated and the widths set on a <colgroup>; Kanban: buildKanbanLanes() gives each lane its own columns and a card can only be dropped inside its lane; Gantt: buildGanttLanes() over one shared window, with the date header repeated and tasks without a date listed once at the end. The fold state of a lane is saved per field
• Group: GroupField and TASK_GROUP_OPTIONS gained startDate and scheduledDate; the Gantt got GANTT_GROUP_OPTIONS (None, Area, Status, Priority) with a flat mode (buildGanttTaskRows()) and fold keys prefixed by field (ganttGroupKey(), the area keeps its key)
• Tests: new Node tests for the filters, the calendar filters, the lanes, the chip model, the lane views, the group dates, the Kanban lanes and the Gantt lanes (tests/*.test.cjs, run with node --test "tests/*.test.cjs")
• Documentation: the user manual (English and Spanish) covers filters with several values, the calendar filter bar, the new chips and Lanes

Version 1.1.13 📊

• Kanban view (kanban-view, icon square-kanban): columns by status, priority, tags or folder built by kanban-board.ts, with the shared filter bar and its own saved state (kanban-state.ts). Dropping a card on a status column goes through the same status logic as the calendar menu (✅ added or removed, next occurrence of recurring tasks); on a priority column it rewrites the priority emoji. Tags and folders are read-only groupings. Columns fold into a thin bar (kanban-collapse.ts): empty ones start folded, only manual choices are remembered, a folded column accepts drops and opens itself, and each column scrolls on its own up to the visible height
• Gantt view (gantt-view, icon chart-gantt): pure logic in task-gantt.ts (bar, milestone or nothing from 🛫/⏳/📅, 7/14/21-day or calendar-month windows aligned to the configured week start, percentage positions, week bands, grouped rows and a dependency index), state in gantt-state.ts, grouped by area and sub-area. A bar that leaves the window is clipped; a hand-written range that ends before it starts is drawn as a milestone with a warning. Tasks without dates sit in a collapsible group below the chart (max width 80%)
• Gantt editing: pointer events with one-day steps; shiftTaskDates() was extracted from task-recurrence.ts so moving a bar and creating the next occurrence share it (it only touches 🛫, ⏳ and 📅 and keeps the time and duration of ⏳). Edges rewrite one field with the existing line helpers; a milestone handle creates the next date in the start → scheduled → due chain. Writes go through updateTaskLine() with the line text shown by the view
• Settings: showListTab/showTableTab became showTasksTab (off only if both were off), new showHabitTab, showKanbanTab and showGanttTab, in both settings code paths and all six languages
• What's new window: lastSeenVersion and showWhatsNewOnUpdate settings, localized entries in src/locales/*.json (no network), shown once and accumulating skipped versions; installing from scratch shows nothing
• Habits folder: the first habit of a missing folder offers to create the path (validated: relative, no .., no forbidden characters), Settings reports whether the folder exists, and Routine and Dashboard now name the folder like the other habit views
• Filters and labels: "Root" in the Area and Sub-area filters (ROOT_AREA, hasDirectTasks()), "Group:" and "Sort:" labels, habit sort options without "By"
• Calendar fix: Week, Work Week and List used weekday % 7 on a list rotated by the week start; they now use (weekday - weekStartDay + 7) % 7. Reported and fixed by @AidanAJoyce in #58, with the repository's first test file (tests/calendar-weekday-labels.test.cjs)
• Documentation: the README links to the user manual (English and Spanish), which now covers Kanban, Gantt and the new settings

Version 1.1.12 🗂️

• Shared building blocks: a generic grouping engine (groupTasksByField), a shared filter bar and view state, and a shared gesture helper (attachTaskGestures) now used by the calendar, List and Table; the calendar and these views no longer carry their own copies
• Areas and sub-areas (src/core/area.ts): area = first folder of the note, sub-area = the remaining folder path without depth limit, "No area" for notes in the vault root. Added Area and Sub-area filters (the sub-area appears once an area is chosen) and area/sub-area grouping with colored headers; tasks directly in an area's folder are listed last under "No sub-area", and sorting by Area follows the same rule
• One Tasks tab: list-view and table-view stay registered (saved workspaces keep working) and a segmented List | Table switch moves between them, keeping search, filters, grouping and sort order. The tab opens the last mode used; showListTab/showTableTab now control which modes are available, and with only one visible the switch is hidden
• Filter bar with chips: the old combos became a + Filter button with native step-by-step menus (type, value and, for Area, sub-area), a row of removable chips with Clear, and search that moves to its own line on narrow windows. The "All tasks" status option, which was easy to misread, is gone
• Grouping and sorting in List and Table: None, Area and sub-area, Folder (flat), Status, Priority, Tags, Due date; sort by Priority, Status, Task, Area, Start, Scheduled, Due, Closed, Tags. Table group headers collapse and remember their state
• Table dates: the Dates column was split into Start (creation date below), Scheduled (time and duration below), Due and Closed (done or cancelled); each column is hidden when no loaded task has a value for it (decided on all loaded tasks, so the table does not change shape while filtering). The Folder column became Area, the file path is shown small under the task, row numbers were removed and Priority, Status and Task are narrower
• Fit to width: Table columns shrink proportionally to the real container width (window on desktop, device width on tablets and phones) without going below their minimum; the Task text wraps and the layout is table-layout: fixed
• Date filters per type: the single Date filter became Due, Start and Scheduled, sharing With date, Overdue/Past, Today, Next 7 days, Future and No date, compared by day. "Overdue" counts only open tasks (not done, cancelled or non-task); the texts "Overdue today" and "Overdue this week" were corrected to "Due today" and "Due in the next 7 days"; "With date" and "No date" now apply to the chosen type. Saved filter values keep working
• List: shows the start (🛫), scheduled (⏳ with 🕐) and due (📅) dates of each task when present, and gained the right-click status menu
• Automatic refresh: TaskManager emits tasks:changed only when the signature of the task lines changes (debounced, and only while a view is listening), HabitManager emits habits:updated when the habit folder content changes, and a DayChangeWatcher emits day:changed at local midnight. Views redraw through a RefreshScheduler (0.4 s), keep their scroll position, skip the loading skeleton, wait while a modal, menu, date picker, drag or text field is active, and refresh when they become visible again if they were hidden; a refresh after the view's own edit is skipped. The Habit Routine and the "today" highlights now change day without interaction
• Ids and safe writes: Task.id is now always the position (path#line) and the 🆔 has its own field; writers compare the expected line text before writing and, if it differs, look for the exact line or cancel with a notice. The fallback extractor no longer numbers lines by task count instead of file position
• Table custom columns and CSV export, announced earlier but never implemented, were removed from the README and the user guide until they ship

Version 1.1.11 🛠️

• Android layout fixes: Obsidian's mobile and tablet styles pad every <button> with 20 px on each side and give it a taller height, which broke fixed-size and icon buttons. Overrode that padding on the calendar view-type switcher (icons were collapsing to zero width), the date picker cells and header, the Day view sidebar toggle, the Habit Routine completion circle, the Habit Grid and Weekly cells, the Task Modal priority/status pills, date triggers and advanced-fields toggle, the Habit Editor chip remove button, the Table search clear button and the habit "+" and related-file buttons
• Habit Routine: hover-only action buttons are hidden on touch devices and no longer reserve space that left habit names empty on narrow screens; clicking a habit name opens the Habit Editor and double-clicking opens the note; priority, area and daytime tags no longer wrap inside their fixed-height pills, and long area tags are truncated with an ellipsis
• Calendar List view: a localized month abbreviation is shown on each row
• Header tabs are readable in dark themes without hovering
• Table view: removed the File column; the row-number column is capped at 50 px and the dates column at 80–120 px
• Corrected the List view descriptions in the README and the user guide (no advanced filtering, custom columns, grouping by date/status or bulk actions)
• Dependencies updated within their ranges (Handlebars 4.7.10 fixes a critical advisory; production npm audit now reports no vulnerabilities); esbuild-sass-plugin stays on the 3.3 series because newer versions require esbuild 0.27+
• Fixed lint findings from the updated rules: no-base-to-string in the habit parser and the concat template helper (non-text frontmatter values are no longer printed as [object Object]), and removed the deprecated setDynamicTooltip() from settings sliders (on Obsidian versions that predate the inline value display, sliders no longer show their value while dragging)

Version 1.1.10 📋

• Calendar List view: one row per day in a continuous window, with a new Settings ▸ Calendar ▸ List view: days to show slider (7–14, default 14); rows reuse the same task-pill rendering as Month/Week, no "N more" collapsing
• List view gestures match the rest of the calendar: click a pill to edit, double-click to open the note, right-click for the status menu, click a row to select/highlight that day without moving the displayed window, double-click empty row space to create a task
• View-type selector gained a 7th icon button (list-todo) for the List view, placed before the Day view button; a date-picker popover button was also added to the Day and List views
• Day view multi-day mode (1/3/5): shows 1, 3 or 5 day columns at once with the reference day centered, sharing the hour grid, duration blocks and overlap lanes per column; dragging a task across columns now also reschedules its date, not just its time
• Task status management from the calendar: new "On Hold" status, a status icon on every calendar task pill, and a right-click context menu (plus a Task Modal field) to change status; marking "Done" adds the completion date and removing it clears the date, mirroring the native checkbox
• Fixed: task-filter.ts compared a task's status symbol against status text instead of the status name, so completed/cancelled tasks were never excluded from filters that relied on it
• Recurring tasks (🔁): completing a recurring task inserts a new line above with its next occurrence, computed via the rrule library with support for the when done suffix; 🆔/⛔ are dropped from the new occurrence
• Unified date picker: the due/start/scheduled fields in the Task Modal now open the same calendar date-picker popover used across calendar views, including the dot marker for days with existing tasks
• Recurrence field (🔁) in the Task Modal now offers autocomplete with recognized recurrence patterns, including when done variants
• Duration modal rebuilt around a circular time dial (extracted from the Habit Editor into a shared TimeDial component), supporting up to 7 hours in 5-minute steps
• Fixed: Day view "All day" tasks without a scheduled time can now be dragged onto an hour slot to assign a time, and a timed task dragged back to "All day" has its time/duration cleared; fixed the related dragover handler that silently blocked the drop
• Fixed: "All day" tasks in the Day view were missing the pill styling (background, accent border, shadow) used everywhere else in the calendar

Version 1.1.9 📆

• Duration-aware Day view: scheduled tasks render as half-hour-aligned blocks — connected across hours for 60+ minute tasks, half-cell for shorter ones — with overlapping tasks placed in side-by-side lanes instead of covering each other
• Resize a task's duration by dragging the bottom edge of its block in the Day view, snapping to 30-minute steps with a live duration tooltip
• Dragging a task to a new slot in the Day view now snaps to the exact half-hour under the pointer (:00/:30) instead of preserving the original minute
• Shared reference date: switching between calendar view types (Day/Week/Work Week/Month/Year) keeps the current date instead of resetting to today; the selected date is highlighted distinctly from "today" in Month/Week/Work Week/Year
• New date picker popover (Month/Week/Work Week/Year) and always-visible docked picker (Day) to jump to any day, month or year
• Clicking a day cell in Month/Week/Work Week/Year now selects and highlights it as the reference date, without interfering with the existing double-click-to-create-task gesture
• The calendar view-type dropdown was replaced with a compact row of icon buttons with tooltips
• Double-click to create a task directly in the Day view: hour slots prefill date and time, the "All day" section prefills date only
• Day view sidebar (mini-calendar) can now be collapsed
• Fixed: TaskModal ignored the pre-filled date when creating a task from a double-click in Month/Week/Work Week/Year, always defaulting to today
• Fixed: a tooltip could be left orphaned in the DOM when switching calendar view types
• Fixed: the Work Week view's task click opened the note directly instead of the edit modal, inconsistent with the rest of the calendar views

Version 1.1.8 🪟

• Refined the task List view with compact rows, clearer folder hierarchy, priority cues, and a stable margin across flat/hierarchical modes
• Refined the task Table view: corrected control styling, improved filter/search layout, status and priority cues, date grouping, and responsive horizontal scrolling
• Added accessible Table sorting by keyboard, persistent search/filter/sort state, and column widths adapted to visible filtered content
• Added a reusable themed tooltip component for plugin views and task modals; expanded task-dashboard widget explanations in English, Spanish, German, French, Italian, and Portuguese

Version 1.1.7 🐛

• Habit views now wait for the initial cache load after saved settings are ready, preventing empty/partial views after startup or plugin updates
• Fixed duplicated YAML frontmatter when editing a habit by replacing the two-step processFrontMatter + vault.process flow with one write that reconstructs a single block; existing duplicates are repaired on the next edit, preserving completions and entries
• Dashboard percentages by area/daytime count completed occurrences individually; a completed morning occurrence counts even if afternoon is still pending
• Grid and Weekly use the same localized daytime badge for occurrence rows; habitShowSingleDaytimeLabel controls the badge for single-daytime habits (default on)
• Grid and Weekly remember their last selected sort order; the Habit List status column is sortable
• Routine groups can be collapsed independently, with each group's state remembered
• Habit Grid, Weekly and List use consistent gestures: single-click opens the Habit Editor and double-click opens the underlying note
• Area palette lookup normalizes folder names (for example, daily plan matches daily-plan)

Version 1.1.6 🐛

• Fixed duplicated YAML frontmatter when editing a habit by replacing the two-step processFrontMatter + vault.process flow with one atomic write that parses, updates and reconstructs a single frontmatter block
• Existing habits affected by duplicated frontmatter are normalized the next time they are edited; completions and entries remain preserved
• Habit Grid, Weekly and List views now use consistent gestures: single click opens the Habit Editor and double-click opens the underlying note, with click/double-click disambiguation

Version 1.1.5 🐛

• Fixed stale Habit Tracker data after editing a habit: HabitManager.refreshCache() now parses frontmatter from the freshly read file content rather than relying on Obsidian's asynchronously refreshed metadata cache.
• Made production builds portable to CI by restricting the local-vault copy step to development/watch mode.
• Added a GitHub Actions release workflow that installs dependencies from package-lock.json, builds from the pushed version tag, validates the tag against manifest.json, and publishes the generated artifacts.

Version 1.1.4 ⏰

• Time-of-day scheduling: scheduled tasks can now include a 🕐 time (HH:mm, 24h) and, when a time is set, an ⏱️ duration in minutes for block-mode tasks; both are fully optional/additive and recognized anywhere on the line, so existing notes and the Obsidian Tasks plugin keep working unchanged
• New editor integration: a right-click context menu and an "Insert task field" command let you add/replace due, start, scheduled date, scheduled time, duration and priority on the current task line without leaving the editor or opening a modal
• New custom iOS-style scroll wheel picker for scheduled time, and a small modal for duration
• Calendar views gained a new Settings ▸ Calendar group to choose which date types (due/start/scheduled) appear, each with a distinct icon + color badge; completed tasks are now dimmed (or hidden, via a setting) instead of always shown at full opacity
• Day view rebuilt: a real hour-by-hour grid populated from scheduled times, plus a collapsible "All day" section for due/start (and scheduled tasks without a time)
• Drag and drop support in calendar views: drag a task to another day (Month/Week/Work Week) or another hour (Day) to reschedule it in place
• Edit tasks from the calendar: click a task to open an edit modal prefilled with all its data (single click edits, double click still opens the file)
• Task creation/edit modal redesigned: scheduled date is the default field (was due date), priority is now a one-click segmented selector, and a collapsible "More fields" section holds start date, due date, recurrence, dependencies, on-completion behavior and a custom ID
• Various small fixes: task-pill title truncation in calendar views, off-by-one when rewriting a task line in place, and parser robustness so time/duration are recognized regardless of where they appear on the line

Version 1.1.3 🧩

• New optional sub-area field for habits: a combobox populated from the 2nd/3rd-level subfolders of the chosen area (e.g. body/salud), hidden by default via a new setting — shown below the area in the List and Routine views when enabled
• Habit related files: replaced the single relatedFile picker with a multi-value field — add wikilinks one by one and remove them individually as removable chips
• Habit description is now stored in the note body instead of the frontmatter (with backward compatibility for existing notes)
• Habit List view now sorts by name by default (was priority)
• Fixed a race condition where editing or deleting a habit made it briefly disappear from the Routine/List views until a manual reload
• Fixed a settings-loading bug where new habit settings could silently reset to their default on every reload

Version 1.1.2 🎯

• Habit subArea replaced by relatedFile: link a supporting note to a habit (wikilink-aware), with the same file picker/autocomplete UX as the task modal; openable from the Table (🔗 column) and Routine views
• Habit Editor: frequency dropdown and weekday checkboxes are now two-way synced (picking a preset checks the matching days; checking days updates the dropdown to the matching preset or "Custom"); blocks saving with zero days selected
• Habit Editor: Daytime and weekday checkboxes now lay out in a fixed 3-per-row grid
• Grid/Weekly views: unscheduled days sandwiched inside an active streak now render as a thin connecting line instead of breaking the pill; a habit completed on a day that's since been removed from its frequency now shows a distinct "conflict" marker (circle with red diagonal) instead of silently fading away
• Grid/Weekly views: fixed a brief flash of the wrong pill shape during the optimistic toggle-then-refresh window
• Table view now includes inactive habits with a read-only Active/Inactive column, and only responds to double-click (single click no longer opens anything)

Version 1.1.1 🔧

• Settings tab now implements the Obsidian 1.13+ declarative settings API (getSettingDefinitions()), so plugin settings are findable via the global settings search on newer Obsidian versions; the legacy display() implementation is kept for older versions
• Distinct workspace tab icons per main view (Overview, List, Table, Calendar, Habits) instead of a shared icon
• Various type-safety and lint cleanups across the Habit Tracker module (no unnecessary type assertions, no unsafe any access)

Version 1.1.0 🌱

• New Habit Tracker module with 5 dedicated views: Grid, Daily Routine, Dashboard, Weekly and Table
• Habit Creator modal to create/edit habits (circular time dial, priority/max-gap sliders, status switch, color picker)
• Habit area is a free-form field with vault-folder suggestions (no fixed category list)
• Configurable sort order (alphabetical, area, daytime, priority, streak, %) across Grid, Weekly and Routine
• Routine view can group habits by daytime or by area
• Dashboard now shows side-by-side area/daytime breakdowns, a 30-day history chart with axis legends, and a new GitHub-style yearly heatmap; it's the new default habit view
• Streaks rendered as merged "pill" runs on the Grid and Weekly views

Version 1.0.6

• Fix calentar weekday

Version 1.0.5 🎨

• Improved loading experience with skeleton loading (replaced spinner)
• Enhanced list view aesthetics and visual design
• Priority distinction and highlighting in list view
• New hero widget added to dashboard
• Various UI/UX improvements and polish

Version 1.0.4 ✨

• Native task creation from calendar views (add task to calendar)
• Command palette integration (Ctrl+P shortcut for task creation)
• Task reload button in toolbar
• Mouse over highlight in list view
• Alphabetical sorting in list view
• Day line indicator in month view
• Navigate to day view from year view

Version 1.0.3 🎨

• Configurable view header tabs
• Display today's date in Overview tab
• Week number display in header

Version 1.0.2 🐛

• Calendar view year view
• Various bug fixes and stability improvements

Version 1.0.1 🚀

• Enhanced compatibility with Tasks plugin dataview format
• Recursive/repeating tasks support (🔁)
• Mobile device support

Version 1.0.0 🎉

Included Features:

• Multiple task visualization views (Overview, List, Table, Calendar)
• Full compatibility with standard Obsidian task format
• Integration with Obsidian Tasks plugin metadata
• Advanced filtering, sorting, and grouping capabilities
• Customizable display options and themes

Known Limitations (at release):

• Task creation and editing requires Markdown files or Obsidian Tasks plugin
• Calendar view does not support time-of-day scheduling
• View-only functionality for most task operations

🗓️ Planned for Future Versions

• ⬜ Dashboard: a task heatmap, habit widgets and a "life dashboard" with tabs
• ⬜ Table: customizable columns and layout, and CSV export
• ⬜ A clock-face time picker, closer compatibility with the Tasks plugin and custom task statuses
• ⬜ Google Calendar sync, followed by Google Tasks and Microsoft

🤝 Contributing

We welcome contributions! Whether it's bug reports, feature suggestions, or code improvements:

1. Report Issues - GitHub Issues
2. Submit PRs - Fork the repository and create a pull request
3. Improve Translations - Help translate the plugin to more languages

Development Setup

# Clone the repository
git clone https://github.com/elias-shalom/obsidian-agenda.git
cd obsidian-agenda

# Install dependencies
npm install

# Start development
npm run dev

# Build for production
npm run build

# Run the tests
node --test "tests/*.test.cjs"

🙌 Contributors

Thank you to everyone who has helped improve Agenda Tasks:

• @AidanAJoyce — fixed the weekday labels of the Week, Work week and List calendar views when the week does not start on Sunday, and added tests for it (#58, shipped in 1.1.13).

🚀 Releasing a New Version

Releases are built by CI (.github/workflows/release.yml), not from a local machine, so the published main.js is always reproducible from the tagged source with the exact dependency versions in package-lock.json. To publish a new version:

1. Bump the version (updates package.json, manifest.json and versions.json together):

   npm version 1.2.0 --no-git-tag-version
   

2. Update the README — add the new version to the News and Changelog sections.
3. Commit those changes (version bump + README) to the target branch and push.
4. Tag the release commit with the exact version number (no v prefix — it must match manifest.json's version field exactly, or the workflow's version check will fail the release):

   git tag 1.2.0
   git push origin 1.2.0
   

5. GitHub Actions then automatically: checks out that tag, runs npm ci (clean install from the lockfile) + npm run build, verifies the tag matches manifest.json, and creates the GitHub Release with main.js, manifest.json and styles.css attached — built entirely inside the CI runner, never uploaded by hand.

Note: the dist/**/* → local vault copy step in src/esbuild.config.mjs only runs during npm run dev (watch mode) for local testing convenience — it's skipped automatically in npm run build (used both locally and by the release workflow) so it never affects release artifacts.

💬 Support and Feedback

Getting Help

• 📘 Read the User Manual: English · Español
• 📖 Check the Wiki
• 🐛 Report bugs on GitHub Issues
• 💡 Suggest features via GitHub Discussions

Feedback

Your feedback helps us improve! Please share:

• Feature requests
• Bug reports
• Usage suggestions
• Translation improvements

⭐ Support Us

If you find this plugin useful, please consider:

• ⭐ Starring the GitHub repository
• 📢 Sharing it with others
• 💬 Reviewing the plugin in Obsidian Community
• 🐛 Reporting bugs and suggesting improvements on GitHub
• 🌍 Contributing translations to support more languages

📄 License

This project is licensed under the MIT License.

Made with ❤️ for the Obsidian community