Task Trellis

by mason-bryant
5
4
3
2
1
Score: 40/100

Description

Obsidian plugin: vault tasks on a kanban board, with workflow columns across and due-date rows down.

Reviews

No reviews yet.

Stats

2
stars
322
downloads
0
forks
25
days
8
days
8
days
78
total PRs
0
open PRs
0
closed PRs
78
merged PRs
2
total issues
1
open issues
1
closed issues
78
commits

Latest Version

9 days ago

Changelog

Task Trellis 1.4.1

Reinstalling keeps your boards and settings

Uninstalling a plugin deletes its settings, and Obsidian Sync deletes them on your other devices too. After a reinstall, Task Trellis looked for boards in its default folder, Task Trellis. If yours were somewhere else, it said you had none and offered templates. Your board notes were never affected.

  • A copy of the settings: every time they're saved, Task Trellis also writes a copy to Task Trellis recovery/plugin-settings.json, outside its own folder. After a reinstall it restores that copy and says so once.
  • Finding your boards: with no settings and no copy, Task Trellis looks for board notes elsewhere. If they're all in one folder, that becomes the boards folder, with a notice. If they're in several, the boards sidebar offers each, as Use ‹folder›, instead of the templates.
  • Settings changed by Sync are taken up as soon as they arrive. Before, a device with old settings in memory could save them back over newer ones from another device.

You never need to uninstall Task Trellis to update it. See My boards disappeared after reinstalling.

Notes opened from a board's tab open in the editor

With a board showing in a tab, opening another note in that same tab, from the file explorer or a link, showed the note as a board. It also added a slug property to the note. Now the note opens in the editor, untouched, and another board still opens as a board. If your notes gained a slug: line this way, you can delete it; only board notes use it. Thanks to the user who reported this in issue 60.

Compatibility

Requires Obsidian 1.13.7 or later. Nothing to migrate: existing settings, boards and tasks are kept.

  • The settings copy is written the first time the settings are saved after updating, such as when you collapse a row. It's a small JSON file in the Task Trellis recovery folder, which rename recovery already uses, and it holds only the plugin settings. It syncs if your sync service includes JSON files. To reset the settings with a reinstall, delete it first.
  • Earlier releases ignore the copy.

Validation

  • Automated: 1020 application tests and 8 shortcut tests, lint, TypeScript checking, the harness build and packaging, locally and in CI.
  • Browser preview (the harness): the boards sidebar offering folders that hold boards, and choosing one.
  • Native macOS, Obsidian 1.15.0, in a disposable vault with boards in a folder other than the default, using Obsidian's own uninstall and enable, and a real click on the sidebar's folder button:
    • Reinstalling with the copy restored the settings, with a notice; reloading without saving restored them again without a second notice.
    • Reinstalling without the copy made the one folder holding boards the boards folder, with a notice, as did a first install into a vault that already had boards there.
    • With boards in two folders, the sidebar came forward offering both, and choosing one brought its boards back.
    • Obsidian's error log was clean.
  • Notes in a board's tab, on Obsidian 1.15.0: reproduced first on the 1.4.1 code without the fix. A task note opened in a board's tab, as the file explorer opens it, showed as a board and gained slug: personal. With the fix, it opened in the editor unchanged, Back returned to the board, and another board opened in the same tab still showed as a board.
  • Before tagging: the same code was installed in the maintainer's own vault, where it loaded every board with its settings intact.
  • Not tested:
    • Sync starting the settings reload. Obsidian calls it only when Sync changes the settings file, so it was tested by calling it directly.
    • A real reinstall on a phone with Sync, and phones and iPad generally.
    • Obsidian 1.13.7, Windows, where the board's tab problem was reported, and Linux.

README file from

Github

Task Trellis

Turn tasks scattered across your vault into a clear plan.

Task Trellis is a configurable kanban board for Obsidian. Bring tasks from daily notes, meeting notes and project pages into one view, while keeping each task in its original note. See what you're working on now, what needs to get done this week, and what should come next from your backlog.

Build boards around the way you work, use color to distinguish projects and categories, and capture ideas from your phone while they're fresh.

Quick start · iPhone capture · AI agents · Guides

Task Trellis showing a sample work board: a Backlog of undated ideas, workflow columns of different widths, a Due now row and the next week, named labels, an overdue task, subtasks with some done, links in task text and struck-through completed tasks

See progress and timing together: columns show where work stands, and date rows show when it needs attention. The board above is a sample Work board in Obsidian; the phone screenshot below uses sample tasks in the browser preview.

See what matters and decide what comes next

  • Know what you're working on. Give work a clear place in columns such as Backlog, Doing, Waiting and Done—or name your own stages.
  • Plan the week ahead. See overdue tasks, upcoming deadlines and undated ideas together. Choose the planning window and drag cards between date rows to reschedule them.
  • Give your backlog a useful order. Reorder cards, bring the next task into focus, and leave ideas without a due date in their own row or column until you're ready to schedule them. Arrange → Sort by due date puts every date row in order, sooner first, moving as few cards as it can.
  • Triage a group at once. Select cards individually, by column, or after filtering, then change their column, due date, labels or priority together. Bulk triage →
  • Recognize projects and categories at a glance. Assign multiple colored labels to a card: Urgent, Financial planning, Paint kitchen, or whatever matters to you. Each board has its own label names and colors, shown as pills, circles or squares.
  • Choose the right scope. Build separate views for work, home or a specific project. Include or exclude tasks using tags, folders and note properties.
  • Keep the context close. Add subtasks from the card, expand them when you need the detail and collapse them for an overview, and reorder them by dragging on desktop. Open any card's note in a pop-up editor over the board, or in a tab.
  • Let an AI agent help. Agents such as Claude Code and Codex, and your own scripts, can read boards and add, move, complete and triage tasks through Obsidian's command line, with the same safety checks and Undo as the board. Agents and the CLI →

Keep working with the tasks you already have

Your tasks stay as Markdown checkboxes in your notes. Board actions update those tasks directly, and board placement and label assignments are stored as ordinary tags. Your notes remain available to Obsidian search, task queries and workflows built around your Markdown.

The same task can appear on several boards without being copied. Each board can give it a different column, order and set of labels; completion and due dates belong to the shared task. For example, Review the budget can appear on both a Work board and a Financial planning board, and completing it updates both.

The optional Tasks plugin adds its task editor and recurring-task behavior. New tasks can go into a specific note or today's daily note, with an optional heading. You can keep capturing work where it already belongs. Integration details →

Capture an idea from your phone

Add a task as soon as it occurs to you, with a due date or without one, and with its labels. + Add task sits at the top of each mobile task list, and under the open board in the boards sidebar, which adds to the top of that board's backlog. The ready-made iOS shortcut sends a task to your chosen vault and board, opens Obsidian, and saves it to the board's configured note.

When you're ready to review, swipe between full-width columns, check off tasks, assign labels, and move cards using the drag handle or Move to… menu. You can capture on your phone and plan on a larger screen using your existing vault sync.

Set up the iOS shortcut →

Work with AI agents and scripts

Ask an agent to "add a Paint kitchen task with three subtasks to my Kitchen note" or "move everything overdue on my Home board to next week", and it can do it with commands such as:

obsidian task-trellis:boards
obsidian task-trellis:show board=home
obsidian task-trellis:add board=home note="Projects/Kitchen.md" text="Paint kitchen" subtasks='["Buy paint","Tape the edges","Paint the walls"]'

The commands answer in JSON. They see each board as you do, refuse to overwrite tasks that changed since they were read, and offer a dry run and Undo. They need desktop Obsidian 1.13.7 or later with Settings → General → Advanced → Command line interface turned on, and Obsidian running. Set up agents and the CLI →

Make it pleasant to come back to

Choose from eleven label color schemes or create your own colors. Switch back with Previous scheme if you prefer the old palette. Resize columns on desktop and tablet, use compact spacing when you want more on screen, and collapse subtasks to keep the board easy to scan.

Find a card by typing in Search cards…, or press Cmd/Ctrl+F in a board: it matches the card's text, note name and labels, and a matching subtask brings its card along. Narrow the board in one click with quick filters in the toolbar. Boards start with some, such as High priority and Overdue, and you can add your own for priorities, labels, due dates, tags, folders or note properties. Turn on several at once to focus further, keep the ones you use less in a menu, and each board remembers which ones you left on. Color rules tint the cards they match, such as everything in a client's folder, using the same choices as quick filters, in any color and opacity, solid or in a pattern such as stripes.

In Appearance, choose the label shape, whether completed subtasks move to the end of their list or are hidden, whether overdue cards get a red edge, and whether notes open in a pop-up or a tab. Big boards stay quick: a long cell shows 25 cards at a time, with more for the rest.

Rename a board from its title or Settings → General, optionally renaming its tags with a preview and a recovery copy. General also duplicates a board, giving the new one the same columns, labels and filters, and deletes one. Deleting moves only the board note to the trash; none of your tasks are deleted.

Theme-aware styling, keyboard controls for cards, subtasks and settings, screen-reader announcements, and save buttons above the mobile keyboard make everyday interactions easier. Undo is available for task moves, completion changes, label assignments, bulk edits, subtask reordering and sorting.

Quick start

  1. Install and enable Task Trellis from Settings → Community plugins → Browse in Obsidian. The installation guide also covers installing a release by hand.
  2. Run Task Trellis: Create board from the command palette, give it a name, and choose what it starts from: a plain Kanban board, a Weekly planner, a Project, an Eisenhower matrix, or an Example board full of sample tasks to try things out.
  3. The New tasks settings open automatically. Choose A specific note, such as Tasks/Inbox.md, outside the boards folder. Or choose today’s daily note if Daily notes is enabled.
  4. Under Filters in the Setup tab, choose which tasks belong here. Leave filters empty to show tasks across your vault. The destination note must satisfy your filters.
  5. Save with the green checkmark, then select + Add task at the top of a column on your phone. Use the tag icon to assign colored labels.

The Tasks plugin is optional; it adds a task editor and recurring tasks. Set up the ready-made iOS shortcut for faster capture.

Guides

I want to… Guide
Customize columns and due-date groups Board settings
Show the right tasks on each board Filters
Search a board for a card Search the board
Add one-click quick filters to the toolbar Quick filters
Color cards by folder, label, priority or property Color cards
Add tasks, move cards or manage subtasks Tasks and cards
Update several tasks at once Bulk triage
Create and assign colored labels Labels
Capture tasks from an iPhone shortcut iOS Shortcuts
Let an AI agent or script read and update tasks Agents and the CLI

Your vault stays yours

Task Trellis works locally, requires no account, and collects no telemetry. Your existing vault sync carries the task lines and board settings between devices. Privacy and integrations.

Everything is stored in ordinary tags and note properties, and every 1.x release reads what earlier ones wrote. Formats and compatibility.

Help and feedback

Fix common problems · Report a bug or suggest a feature

Development and credits

Build and test locally · Release checklist

Task Trellis is licensed under the MIT license and is inspired by the work of Jaroslav Krčál on 4D Eisenhower Matrix. The runtime also includes monkey-around by PJ Eby (ISC). See third-party notices and the provenance record; all notices are embedded in the generated bundle.