README file from
GithubTask Gantt Board
English | 日本語
An interactive project-management Gantt and Kanban board for Obsidian. One Markdown file = one task; a configured folder is shown and edited as a "table + timeline" Gantt — drag bars to reschedule, link dependencies, set milestones, sort and filter, and move tasks between folders by dragging — or as a Kanban board with a column per status, in several saved views.
Requires Obsidian 1.11.4 or later.
Screenshots
Open a folder as a Gantt from the left-column ribbon button, or by right-clicking the folder → Open as Gantt:

The folder opens as a table + timeline, with groups, bars, milestones, and dependency arrows:

Click a task to open the detail panel and edit its dates, status, assignee, progress, and body:

Usage
- In Settings → Task Gantt Board, set the target folder (e.g.
Projects/Cleanup). - Open the view from the "Open Gantt" ribbon icon in the left column (or the command "Open Gantt"). The ribbon opens the Gantt for the folder of the currently open note — or the folder selected in the file explorer — and falls back to the default folder in settings (the vault root when none is set). You can also right-click any folder → Open as Gantt.
- Direct subfolders become groups, and the
.mdfiles inside them become tasks. - Drag a bar / resize its edges to write the new dates back to that file's
start/endfrontmatter. Every column the table can show is editable in place — just double-click the cell. Start and Due open a calendar, Duration takes a number of workdays, Progress takes a percentage (0–100; blank or 0 clears it), Status opens a dropdown, Assignee is a text field that suggests names already used in the board (type[[to link a note instead), and Tags opens a small editor with a chip per tag (× to remove) and an add field that suggests the vault's existing tags. Enter or clicking away saves, Esc cancels. - Click a task in the table — or double-click its bar — to open a detail panel (dates, status, assignee, progress, body) beside the board, on its right. Links in the body are clickable (internal links open the note, Ctrl/Cmd-click for a new tab, with Page preview on hover); click anywhere else in the body to edit it, and type
[[to insert a link to a note. - Use the + New task button to create a one-day task in the current folder and name it on the spot, and Today to scroll the timeline to the current date. Hovering a bar shows a grip at each end, so you can see where to grab it to stretch the dates; today is marked by a solid red line with the day of the month in a red badge on the date axis.
- Use the Day / Week / Month / Fit buttons to change the timeline scale. Fit auto-scales to the pane width and re-fits when you resize. The timeline is not limited to your tasks' dates: it opens centred on today and keeps extending as you scroll to either side. The date axis has two rows — Day and Week show the week (
W46 Nov 15 - 21, weeks start on Sunday) over the days, like ClickUp, with weekends hatched (they follow the non-working weekdays setting) and today as a red badge on a solid line; Month shows the year over the months, like Wrike. Changing the scale keeps the date in the middle of the view in place. When a task's bar is scrolled out of view, a small ‹ › arrow appears on its row at the left or right edge of the chart (hover for the task and its dates); click it to jump to the bar. Drag the chart's empty background (anywhere but a bar or a dependency line) to scroll sideways.
The UI follows Obsidian's display language. Supported: English, Japanese, Korean, Chinese (Simplified & Traditional), French, Spanish, and Russian; any other language falls back to English.
View options
An options row above the table shapes how the board is displayed. The on/off display toggles — Show empty folders, Roll up, Flat view, Progress line, Hide bar labels, Highlight overdue and Compact rows — are gathered in the Display menu, which lists them as checkboxes like the column menu; the button is tinted when any of them differs from its default. Compact rows shortens every row (30 px to 26 px) so more tasks fit on screen, in the Gantt and the Table view alike; each view remembers its own density.

Group by folder, status, or assignee, and color by status or assignee (with a legend):

Sort by clicking a column header; click it again to flip ascending/descending (↑/↓):

Choose columns with the gear button — show or hide Start, Due, Duration, Progress, Assignee, Status, Tags, and Folder (the task's folder relative to the board, handy in the flat view). Any column shown here can be edited by double-clicking its cell. Double-click a Start or Due cell for the calendar, which also has Start time and Due time fields under it (blank = date only). The Status cell opens a list with each status's color dot. Drag a column header to reorder the columns — the Task column included — and a line shows where it will go; the order is saved per view, and a column you show later joins at the end. The column layout and sort are remembered across sessions:

Turn on Flat in the Display menu to list every task in one sorted list, ignoring folders and nesting:

Progress column: tick Progress in the gear menu to show each task's progress (the progress value, 0–100) as a small bar and a percentage. Double-click a cell to edit it, or use the slider in the detail panel:

Progress line (step 2: turn on Progress line in the Display menu, with the Progress column shown so each number can be read against the line) draws a jagged line down the board from today, bending to each task's achieved progress: left of today means behind schedule, right means ahead. Per row, the line sits at the point on the bar matching the task's progress — so a task due last week but only 40% done pulls the line back to its 40% mark. Tasks at 100% and tasks that haven't started yet (and aren't due to) stay on the today line, as do folder rows and rolled-up parent bars. A task past its start date with no progress pulls the line back to its start date. Its color is configurable in Settings → Task Gantt Board → Progress line color.

Hide bar labels removes the task name and assignee after each bar, for a cleaner chart (off by default: names are shown). Highlight overdue (off by default) outlines in red every bar whose due date has passed and whose status isn't completed or cancelled, adds a ⚠ after the bar, and shows a red ⚠ count on each group heading. Both sit next to the progress line in the options row.
Views
A board (a folder) can hold several views, shown as tabs above the toolbar, like Wrike's views. Each view keeps its own grouping and color-by, the Display menu toggles, filters and match mode, visible columns and their widths, sort, zoom and collapsed groups — so switching tabs switches the whole look at once.

- + adds a view: Copy this view copies every setting and opens the copy next to the original, or Gantt, Table or Kanban adds a new view with the default settings and no filters; its columns start as the title, Start, Due, Assignee and Status.
- Drag a tab to reorder the views (an accent line shows where it will go); the order is saved.
- Double-click a tab, or use the ▾ on the open tab (or right-click any tab), to rename, duplicate or delete a view. The last view can't be deleted, and deleting a view never deletes tasks.
- Changes are saved to the open view automatically. Saved filter presets stay shared by all views. The first time a board is opened, its first view takes over your current settings, so nothing changes at first.
Table view
+ → Table adds a Table view: the Gantt's table without the timeline, for planning and bulk editing like a spreadsheet. It has the same columns, grouping, subtasks, filters and sorting as the Gantt, and everything below works in the Gantt's table too.

- Select cells: click a cell, Shift+click or drag for a range, arrow keys and Tab to move. Enter, F2 or a double-click edits the cell, and Esc clears the selection.
- Copy and paste: Ctrl/Cmd+C, X and V work on the selected cells as tab-separated text, so you can paste to and from Excel, Google Sheets or Wrike. One value pasted onto a range fills the whole range; several values land from the top-left cell. Each column reads text its own way: dates in your display format (or ISO, with an optional time such as
2026/11/02 09:30), status by name, tags separated by commas, progress as60or60%, custom fields by their type. The Task (title) column renames the notes: the first line of the text becomes the file name, links to the note follow the rename, and a title can't be blanked. A folder can't hold two notes with the same name, so a title that is already used in that folder is left unchanged (you're told how many); notes in different folders can share a name. Rows past the end of the table aren't pasted (you're told how many), and read-only cells are skipped. - Fill: drag the small square at the bottom-right of the selection up or down to copy the selected values into the rows you pass. The Task (title) column isn't filled, because a folder can't hold two notes with the same name; pasting different titles still works.
- Clear: Delete or Backspace empties the selected cells (a column that can't be blank, like duration, is left as it is).
- Summary: with two or more cells selected, the bottom of the board shows the count, and the sum, average, minimum and maximum for numbers, or the minimum and maximum for dates.
- Pasting, filling and clearing are each one undo step (Ctrl/Cmd+Z). Paste and fill are a pure copy: a date is written exactly as given, so a new Start doesn't move the Due date and the time of day is the source's. Only the date rules apply: a task never has a start without a due date (an empty Due takes the Start), and if a date would pass the other one, the other follows. Tasks that depend on it still move, as with any date change.
- Add a task: the + Add task row at the bottom of the table creates a task (with the new-task dates from Settings) and lets you type its name right in the table, without opening the detail panel.
- A row is dragged to move it or make it a subtask from its name cell; dragging from any other cell selects a range.
Kanban view
+ → Kanban adds a Kanban view next to your Gantt views.
It shows the board's tasks as cards in one column per status, the way Wrike's Board view does. The columns take their name and colour from your statuses (add a status in Settings and a column appears), starting in the order of the statuses in Settings (a new Kanban view takes that order once, and keeps its own from then on). Tasks without a status go into an Unassigned column, which stays first and shows only while it has cards.
-
Move a card to another column by dragging it: the task's status becomes the column's status (undoable with Ctrl/Cmd+Z). Dropping on Unassigned clears the status.
-
Reorder the columns by dragging a column header. The order is saved in that view (each Kanban view has its own). Settings only supplies the starting order, taken once when the view is first drawn; changing the statuses' order there later (its ▲ ▼ buttons, which also set the legend's order) doesn't change existing views. A status you add in Settings appears at the end of each view's columns, and a deleted one disappears.
-
Collapse columns: the ⋯ in a column header has Collapse column, Collapse empty columns, Collapse all columns and Expand all columns. A collapsed column becomes a thin strip with its colour, count and name; click it to open it again (cards can still be dropped on it). Which columns are collapsed is saved in that view.

-
Swimlanes: the Group button at the left of the toolbar splits the board into horizontal lanes by Assignee or Folder (None turns them off). The column headers stay on top and every lane has the same columns; click a lane's title to collapse it. Dragging a card into another assignee lane changes its assignee as well as its status (one undo restores both); dragging a card into another folder's lane moves the file into that folder (its subtasks go with it and its parent link is cleared; if the status changes too, one undo restores the move and the status). Tasks with no assignee go into an Unassigned lane, and tasks directly in the board's folder into a (top level) lane. The grouping and the collapsed lanes are saved in that view.



-
Order the cards: drag a card up or down in its column (a line shows where it will land), or into another column at the spot you want, which also changes its status (and its assignee in an assignee lane). Dragging switches the view to Manual order, which is saved in that view. The toolbar's Sort button switches between Manual and any column in ascending or descending order, and the manual order is kept while you use another sort. Cards not in the manual order yet go to the end of their column, and renaming or moving a note keeps its place. Changes of order aren't covered by undo.

-
Click a card to open its detail panel.
-
Card fields: a card shows the task name and, by default, its assignee, start and due dates. The Cards button (the list icon at the left of the toolbar, before the folder name) lists every other column, including custom fields, as checkboxes.

-
Add tasks: the + in a column header, or the + Add task button under the cards, creates a task with that column's status (none in Unassigned), using the new-task dates from Settings. A card's ⋯ menu (or a right-click) has Add subtask, which creates a subtask in its parent's folder, Move to folder… (on a board that has subfolders; it opens the list of folders, and the file moves there with its subtasks while its parent link is cleared; undoable), and Delete. The detail panel has the same thing as a Folder dropdown under Status.

-
Subtasks: a card with subtasks shows a count icon; click it to open the first-level subtasks inside the card, each with the same fields as the card. A subtask is not a card of its own while its parent is shown.


-
Filters and presets work as in the Gantt views, and the cards in a column follow the view's sort (Sort button) or its manual order. The view keeps its own filters and card fields, like every view.
-
Make a subtask by dragging: drop a card on the middle of another card (an outline appears; the top and bottom edges still place it before or after) and it becomes that card's subtask, moving into the parent's folder like in the table (undoable). To turn a subtask back into a card of its own, right-click it inside its parent card, or use Detach from parent in the card's ⋯ menu.


Custom fields
Show any frontmatter key as a table column. In Settings → Task Gantt Board → Custom fields, click Add field and give it a key (the frontmatter property, e.g. client), an optional label for the column header, and a type:
- Text — shown as is. A list value is shown comma-separated, and editing it writes a list back.
- Number — right-aligned and sorted numerically.
- Date — shown in your date format and edited with the same calendar as Start / Due (the date part only).

A new field's column is shown right away; hide or show it from the gear menu like any other column. Custom columns sort by clicking their header and are edited by double-clicking a cell, and every edit can be undone. The detail panel shows every custom field too, between Progress and the body, and edits it there (even when its column is hidden), and the Kanban cards can show them from the gear menu. Changing a field's key keeps its column's visibility, width and sort, and takes effect when you press Enter or leave the box. If notes still hold values under the old key, you're asked whether to rename that property in those notes too (a note that already has a value under the new key is never overwritten) or only to point the column at the new key. Keys the plugin already reads (the Start / Due / Status / … keys under Frontmatter keys, and tags) can't be used, and if two fields share a key only the first becomes a column — the settings tab says so.

Filters
A filter row below the options narrows the board. Click Add filter and pick a field — Name, Status, Status group, Assignee, Tag, Folder, Start date, or Due date — then set its condition. Each filter shows as a chip you can click to edit or remove with ×.
-
Name matches with is / is not / contains / does not contain / starts with / ends with.
-
Status / Status group / Assignee / Tag let you tick several values — including (none) for unset — with is / is not / is empty / is not empty.
-
Folder (offered when the board has subfolders) lists the folders that hold tasks, relative to the board; ticking a folder includes the folders below it, and (top level) is the tasks directly in the board's folder. It works in every view, so a Kanban board can be narrowed to one folder.
-
Start date / Due date compare against a preset (yesterday/today/tomorrow), a specific date, a relative date (e.g. 1 week from now, recomputed each day), or a date range, with is / before / after / on or before / on or after / empty / not empty.
-
Custom fields you made in the settings appear at the end of the Add filter list, and filter by their type. Text: is / is not / contains / does not contain / starts with / ends with / empty / not empty (case-insensitive; a list value matches when any one of its items does, and is not / does not contain when none does). Number: = / ≠ / > / < / ≥ / ≤ / empty / not empty. Date: the same choices as Start and Due. A task without a value drops out of every comparison except empty. Deleting a custom field removes its filters.

With two or more filters, choose Show items matching → Match all (AND) or Match any (OR) on the right.
Presets
Open Presets for one-click filter sets. Built-in presets are No dates (no bar), Has dates, Overdue, Unassigned, Completed, and Incomplete. The last two read the status group rather than status names: Completed is everything in the Completed group, and Incomplete is everything that is neither Completed nor Cancelled — active work, deferred work, and tasks with no status at all. Build any combination of filters and save it as a preset by typing a name — saved presets can be re-applied or deleted, and Clear filters removes them all. Filters and presets persist across sessions.

Moving tasks between folders
When grouped by folder, drag a task row onto a folder to move the task into it (or onto another task to drop it into that task's folder). Links are updated automatically, and the move is undoable with Ctrl/Cmd+Z or the undo button. Empty folders stay visible as rows so you always have a drop target; the Show empty folders toggle (on by default) controls this.
Manual order
Drop a task row on the top or bottom edge of another row (a line shows where it will go) to place it before or after that row; the middle of a row still makes it a subtask. The view switches to Manual order, which is saved per view (Display → Manual order turns it on or off, and clicking a column header goes back to sorting by that column; the saved order is kept). Under folder grouping, dropping next to a row of another folder or parent also moves the task there (with its subtasks); in the flat view and under other groupings only the order changes. Rows are never ordered by hand unless you choose it: date order stays the default. Changes of order aren't covered by undo, but the move is.
Subtasks
Give a task a parent (a single wikilink to another task) and it nests under that parent in the table, with a chevron to collapse or expand. When grouped by folder, drag a task onto another task to make it a subtask — it moves into the parent's folder with its whole subtree; drag it onto a folder to detach it back to the top level. Cycles are blocked, and every move is undoable. The Roll up toggle draws a parent's bar (and its Start/Due cells) as the span of its descendants. Set or clear the parent from the detail panel.
Tags
Tasks use Obsidian's native tags (frontmatter tags: plus inline #tag), so they stay in sync with Obsidian's search and tag pane. Group by Tag to see a task under each of its tags — a multi-valued task appears in several groups — filter by tag, and show a Tags column of chips. When grouped by tag, drag a task onto a tag group to add that tag, distinct from a folder drop, which moves the task. Add or remove tags in the detail panel, or double-click the Tags cell to open the same editor there. Either way, tags are written to frontmatter tags: — a #tag written in the body is shown but can't be removed from here.
Coloring tags and folders
Every tag starts from a single Default tag color — Obsidian's own tag color unless you change it in Settings → Task Gantt Board → Tag colors — and you can override any individual tag on top of that. Folders get an automatic color from their name instead.
Right-click a folder heading, a tag heading, or a tag chip to change or reset its color. Setting a color registers that tag under Per-tag colors in settings; resetting removes it again, so the list holds exactly the tags you have deliberately coloured — everything else follows the default. You can also add a tag there by picking it from your vault's tags, and removing one asks for confirmation, since the settings tab has no undo. Rows are listed alphabetically. Folder colors are right-click only.
If the video doesn't play above, watch it here.
Creating tasks
Press + New task to create a dated note in the current folder and rename it immediately. You don't have to start there, though: every note inside the target folder already appears as a row — including notes with no dates yet — so you can also click an existing note and set Start / Due in the detail panel to turn it into a scheduled task. Empty cells are double-click editable too, so you can fill a blank value straight from the table.
A new task gets today as both its start and due date by default. Under Settings → Task Gantt Board → Task creation, Dates of a new task can be switched to Backlog (no dates), which creates the note with no dates so you can schedule it later.

Task frontmatter
Each task is a single Markdown file. The schedule lives in frontmatter; the description is the body.
---
start: 2026-02-04
end: 2026-02-07
status: in-progress
assignee: kato
progress: 40
after:
- "[[Sweeping]]" # predecessor (dependency arrow)
---
# Wiping
The body is the task description (shown in the detail panel).
| Frontmatter | Meaning |
|---|---|
start / end |
Start / end date YYYY-MM-DD (bar position and length). A time of day can be added as YYYY-MM-DDTHH:mm+09:00 (edit via the detail panel; the offset follows the Timezone setting). |
status |
Status ID (defined in settings, reflected in bar color; its status group drives the Completed / Incomplete filters). |
assignee |
Assignee (label shown next to the bar). Can be a note link such as "[[John Doe]]" — it's shown as a clickable link, and the note's name is used for the label, legend, filters and grouping. |
progress |
Progress 0–100 (fill inside the bar; editable with the detail-panel slider, or by double-clicking the Progress column). |
after |
Array of wikilinks to predecessors (dependency arrows; violations turn red). |
milestone |
true for a diamond (zero duration). |
gcal |
true opts the task into Google Calendar sync (only used when Sync flagged tasks only is on). |
gcalId |
Set automatically once the task is pushed to Google Calendar — the linked event's ID. Don't edit by hand. |
Milestones: a task that has only an end date (no start) is automatically treated as a milestone and drawn as a diamond. Setting milestone: true does the same. To turn a milestone back into a ranged task, give it a start date.
The task name is the file name (without extension); the group is the parent subfolder name. Frontmatter key names can be changed in settings.
Sample data for a quick try lives in examples/Cleaning Project お掃除プロジェクト/ (point the target folder at it).
Dependencies
Drag from a bar's round handle to another bar to create a dependency. The connected ends decide the type: FS (finish→start), SS (start→start), FF (finish→finish). SS/FF successors snap to their predecessor when you reschedule. An FS successor is pushed later when its predecessor slips into it — it moves to the next workday after the predecessor's due date and keeps its duration — and the push carries on down the chain. Moving a predecessor earlier never pulls its successors back, so gaps you left on purpose stay. Turn this off with Push FS successors automatically in settings. Milestones never move through dependencies. The lines are drawn as elbow connectors with rounded corners. Click a dependency line to remove it (undo with Ctrl/Cmd+Z or the undo button). A dependency that would close a loop (tasks waiting on each other) is refused with a notice.
Duration
The Duration column (turn it on from the gear menu) shows how many workdays a task spans, counting both ends and skipping the non-working days set in settings (Saturday and Sunday by default). It isn't stored anywhere: it's worked out from start and end, which stay the source of truth.
- Change the duration (double-click the cell, or use the field in the detail panel) and the start stays put while the due date moves. A task with no start date starts today.
- Change only the start date and the due date moves with it, so the duration stays the same — the bar slides. Changing the due date changes the duration instead. Dragging a bar's edge on the timeline resizes it as before.
- Together with FS dependencies you can schedule by duration: give each task a duration, chain them with FS links, and a slipping task pushes everything after it.
Export as PNG or PDF
Click the download button in the toolbar (or run an Export command from the command palette while a board is open) and choose a format and a range:

| Chart only | Table and chart | |
|---|---|---|
| PNG | the timeline: date axis and bars | the table's visible columns, then the timeline |
| the same, on A4 landscape pages | the same, on A4 landscape pages |
The export is the board as it is shown now: its filters, grouping, collapsed groups, columns, zoom and theme, and every row, including those scrolled out of view. A title (the folder and today's date) sits on top. A PDF fits the board's width to an A4 landscape page and, if the board is tall, continues on the next pages between rows, with the date axis (and table header) repeated on each. The file goes to the folder where your vault keeps attachments, and a notice offers to open it. A very large board is scaled down to fit the canvas limits; filter it or collapse groups for a sharper image. A PDF holds the board as an image, so its text can't be selected.


Export as CSV
The same menu (and the Export: CSV command) also writes a CSV of the table: the columns you have visible, as the header, and one line per row you can see now, in the order shown (filters, sorting, grouping and collapsed groups apply). Each value is written as it reads on screen: dates in your display format, the status by name, tags separated by commas. The file is UTF-8 with a BOM (so Excel opens Japanese and other text correctly) and goes to the attachment folder like the other exports. In a Table view the menu offers only CSV. There is no CSV import.

Undo and redo
Every change made on the board can be undone with Ctrl/Cmd+Z or the undo button, and redone with Ctrl/Cmd+Shift+Z, Ctrl/Cmd+Y or the redo button: cell edits, everything in the detail panel (including renames and body text), dragging bars, dependencies, moves and subtasks, tags, and creating or deleting a task. Undoing a delete re-creates the note in place. Successors that moved along with a task move back with it. While you are typing in a text field, the shortcuts undo your typing instead. Renaming or moving the board's tasks or folders from the file explorer joins the history too, so undo always walks back in the order things happened. The history lasts while the board is open.
Changes made outside Obsidian — renaming, moving or deleting notes in Windows Explorer or macOS Finder, or by a sync tool — are not part of the history: Obsidian only sees them as a file disappearing and another appearing. Undoing an earlier change to such a note does nothing, so rename and move tasks inside Obsidian (the title field, or Obsidian's own file explorer) if you want to be able to undo it.
Settings
Open Settings → Task Gantt Board to configure the default folder, subfolder recursion, default zoom, and the date display format (YYYY/MM/DD, DD/MM/YYYY, or MM/DD/YYYY; stored dates always stay ISO YYYY-MM-DD).
The Timezone setting (system or a fixed GMT offset, listed with representative cities) controls how times of day are displayed and saved. Changing it re-displays stored times in the new offset.

Non-working days (Saturday & Sunday, Friday & Saturday, Sunday only, or none) are skipped when counting a task's duration and when dependencies move tasks. Push FS successors automatically (on by default) controls whether a slipping predecessor pushes its FS successors.
The Progress line color setting sets the color of the jagged line drawn by the Progress line view option, with a button to reset it to the default amber.
Statuses are fully customizable — add, edit, or delete them. Each status has an id (matches the status frontmatter value), a label, a group, and a color reflected in the bar.
The group is what tells the plugin whether a task is finished. There are four, borrowed from Wrike and not extensible: Active (being worked on), Completed (done), Deferred (paused — on hold, blocked, waiting), and Cancelled (dropped). Every status belongs to exactly one, and the Completed / Incomplete filter presets read only the group, never the status name — so a status called Shipped counts as finished as long as it sits in the Completed group. If no status is in the Completed group, settings say so and the Completed preset stays empty.
Upgrading from 2.8.x: existing statuses are assigned a group once, guessed from their id and label (
done/完了→ Completed,cancelled/中止→ Cancelled,on hold/blocked/保留→ Deferred, everything else → Active). Check the list after upgrading and correct anything the guess got wrong.
You can also rename the frontmatter keys the plugin reads (start, end, status, assignee, after, progress, milestone) to match your own vault conventions.

Notifications (optional)
Task Gantt Board can post reminders for tasks that have a time of day to Discord, Slack and/or Microsoft Teams via incoming webhooks. In Settings → Task Gantt Board → Notifications, set the webhook URLs, choose the targets (start / due), and pick the lead times (1 week / 1 day / 1 hour / 10 minutes before, or at the exact time). Use Send a test message to verify the webhooks instantly.
For Teams, create a channel Workflow (channel … menu → Workflows → template "Post to a channel when a webhook request is received") and paste the generated URL. The retired Office 365 connector URLs are not supported; this uses the current Power Automate webhook, and messages are posted as Adaptive Cards.


- Network use: when enabled, the plugin sends HTTP POST requests containing only the task name and its date/time to the webhook URLs you configured — nothing else is sent, and nowhere else. Leaving both URLs empty (the default) disables all network access.
- Notifications fire only while Obsidian is running. Triggers that passed while Obsidian was closed are skipped, and each trigger is sent at most once.
- Date-only tasks (without a time of day) are never notified.
- The whole vault is scanned — no folder configuration needed; any task with a time of day qualifies.
Google Calendar sync (optional, desktop only)
Task Gantt Board can keep tasks and a Google calendar in two-way sync: task changes (create / reschedule / delete) are pushed as events, and moving or deleting those events in Google Calendar flows back into the task's frontmatter. Each direction can be toggled independently in Settings → Task Gantt Board → Google Calendar.
Setup
The plugin has no server, so it uses your own Google Cloud project:
- In Google Cloud Console, create a project and enable the Google Calendar API.
- Configure the OAuth consent screen (External is fine) and add your own Google account as a test user. Because the app is yours and unverified, Google shows an "unverified app" warning during consent — expected, just continue.
- Create an OAuth client ID of type Desktop app, and paste the client ID and secret into the plugin settings.
- Press Connect — your browser opens Google's consent screen, and the plugin receives the authorization on
127.0.0.1(loopback). Then pick the calendar to sync (a dedicated calendar is recommended).

How it syncs
- Pull only ever touches events that Task Gantt Board itself created. Creating an event directly in Google Calendar does not create a task, and editing or deleting a foreign (non-plugin) event is ignored — the plugin only reads back changes to events it pushed. Anything already on your calendar is left untouched.
- By default only tasks with the
gcal: trueflag in their frontmatter sync (opt-in; toggle it per task in the detail panel — which also shows an Open in Google Calendar link once synced). Turn off Sync flagged tasks only to sync every dated task in the scope folder instead. - Date-only tasks become all-day events; tasks with a time of day on both ends become timed events (using the plugin's Timezone setting); milestones become one-day events. The linked event's ID is stored in the task's
gcalIdfrontmatter key (set automatically — don't edit it by hand). - Local edits push within seconds; remote changes are pulled at the configured interval (default 5 minutes). Titles sync one way only (task → event): renaming the event in Google Calendar is reverted on the next push, since renaming files from outside is risky.
- If both sides changed since the last sync, the newer edit wins and a notice tells you which side was kept.
- Deleting a task deletes its event (configurable). Deleting the event in Google Calendar just unlinks the task by default (optionally also clearing its dates) — files are never deleted.
- Recurring events are not supported (skipped by both directions).
Example — Test1 and Test2 carry gcal: true and pushed through as events; Test3 (no flag) stayed local only. The Test3 from GC event and the 七夕 holiday were created directly in Google Calendar and never became tasks:

Disclosure
- Network use: when connected, the plugin talks to Google's OAuth and Calendar APIs only, sending the synced tasks' name, dates, and a body excerpt (first 500 characters) with a link back to the note. Leaving the feature unconfigured (the default) makes no network requests.
- Account & credentials: requires a Google account and your own Google Cloud OAuth client. The plugin requests only the
calendar.eventsandcalendar.calendarlist.readonlyscopes. The OAuth client secret and refresh token are stored in Obsidian's secret storage (the OS keychain), not in the plugin'sdata.json, so they don't travel with vault sync, backups, or git. Only the client ID stays indata.json. Secret storage is per device, so connect again on each device. Upgrading from 2.9.3 or earlier moves the old plain-text values out ofdata.jsonautomatically; if that file was ever committed to git or shared, reset the client secret in Google Cloud Console and reconnect. - Mobile is not supported (the OAuth loopback needs a desktop); other features work on mobile as usual.
Vault access
To build the board, the plugin lists the Markdown files in your vault and reads their frontmatter through Obsidian's metadata cache. When the board is opened on a folder, only notes under that folder are shown, but notifications look at the whole vault, and renaming a custom field's key searches every note for that key. Nothing read this way leaves your device; the only network use is the optional notifications and Google Calendar sync described above.
Development
npm install # install deps
npm run dev # watch build
npm run build # type-check + production build
npm test # headless model tests
Copy main.js / manifest.json / styles.css into <vault>/.obsidian/plugins/task-gantt/ to enable it.
Design
See docs/adr/ for the rationale behind design decisions (latest: ADR-0005) and CONTEXT.md for terminology.
Limitations
Auto-scheduling (critical path), sub-day time granularity, and cross-folder aggregation are not implemented.
License
MIT — see LICENSE.
日本語
English | 日本語
プロジェクト管理ツールのようなタスク管理 UI を Obsidian で実現するプラグインです。1 ファイル = 1 タスクとし、指定フォルダ配下を 「表+タイムライン」ガントで表示・編集します。バーのドラッグで日程変更、依存の作成、マイルストーン、ソート・フィルタ、ドラッグでのフォルダ移動などができます。ステータスごとの列のカンバンでも表示でき、複数のビューを保存できます。
Obsidian 1.11.4 以降が必要です。
スクリーンショット
左列のリボンボタン、またはフォルダの右クリック →**「Open as Gantt」**から Gantt として開きます:

「表+タイムライン」で開き、グループ・バー・マイルストーン・依存の矢印が表示されます:

タスクをクリックすると詳細パネルが開き、日付・状態・担当・進捗・本文を編集できます:

使い方
- 設定 → Task Gantt Board で対象フォルダを指定(例:
Projects/お掃除)。 - 左列の 「Gantt を開く」リボンアイコン(またはコマンド「Gantt を開く」)でビューを開く。リボンは、現在開いているノートのフォルダ(またはエクスプローラで選択中のフォルダ)を Gantt 表示し、どちらも無ければ設定の既定フォルダ(未設定なら Vault ルート)を開きます。フォルダを右クリック →**「Open as Gantt」**でも開けます。
- 直下のサブフォルダがグループ、その中の
.mdがタスクになります。 - バーをドラッグ/端をリサイズすると、そのファイルの
start/endに書き戻します。テーブルに表示できる列はすべて、セルをダブルクリックすればその場で編集できます。 開始・期限はカレンダー、期間は稼働日数の入力、進捗は % の直接入力(0–100。空欄または 0 で未設定)、ステータスはドロップダウン、担当者はボード内で既に使われている名前を候補に出すテキスト欄、タグは詳細パネルと同じエディタ(タグごとのチップと × による削除+Vault 内の既存タグを候補に出す追加欄)が開きます。Enter またはフォーカスを外すと保存、Esc で取消します。 - 表のタスクをクリック、またはバーをダブルクリックすると、ボードの右に詳細パネル(日付・ステータス・担当者・進捗・本文)が並んで開きます。
- + 新規タスクボタンで現在のフォルダに1日タスクを作ってその場で命名、今日ボタンでタイムラインを今日へスクロールできます。バーにカーソルを載せると、両端につかみの目印が出て、期間を伸び縮みできる場所が分かります。今日は、赤い実線と、日付の軸の上の、日にちを入れた赤いバッジで示します。
- Day / Week / Month / Fit ボタンで時間軸の拡大率を変更。Fit はペイン幅に自動で収め、リサイズにも追従します。時間軸は、タスクの日程に限りません。今日を中央にして開き、左右どちらへスクロールしても、続きが伸びていきます。日付の軸は 2 段で、Day と Week は、ClickUp のように、日の上に週(
W46 11月 15 - 21。週は日曜始まり)を出し、休日(休日の曜日の設定に従います)は斜線、今日は、実線の上の赤いバッジで示します。Month は、Wrike のように、月の上に年を出します。拡大率を変えても、画面の中央の日付は、そのままです。タスクのバーが画面の外にあるときは、その行の、チャートの左端か右端に、小さな ‹ › の矢印が出ます(カーソルを載せると、タスク名と日程)。押すと、そのバーへ飛びます。チャートの何もない背景(バーと依存の線以外)をドラッグすると、横にスクロールできます。
UI 表示は Obsidian の表示言語に追従します。対応言語:英語・日本語・韓国語・中国語(簡体/繁体)・フランス語・スペイン語・ロシア語(その他は英語にフォールバック)。
表示オプション
表の上のオプション行で、ボードの見せ方を調整できます。
表示の入り切り(空フォルダを表示・ロールアップ・フラット表示・稲妻線・バーのラベルを隠す・期限切れを強調・コンパクト表示)は、表示メニューにチェックボックスとして並びます(列の表示メニューと同じ形)。既定から変えたものがあると、ボタンの色が変わります。コンパクト表示は、行の高さを縮めて(30px から 26px へ)、一度にたくさんのタスクを出します。ガントでもテーブルでも使え、ビューごとに保存されます。

グループ化(フォルダ/ステータス/担当者)と色分け(ステータス/担当者・凡例付き):

ソートは列ヘッダをクリック。もう一度クリックで昇順/降順を切替(↑/↓):

列の表示は歯車ボタンから、開始・期限・期間・進捗・担当者・ステータス・タグ・フォルダ(ボードからの相対パス。フラット表示で便利)を出し分け。ここに出せる列はすべてセルのダブルクリックで編集できます。開始・期限のセルをダブルクリックすると、カレンダーが開き、その下の開始の時刻・期限の時刻の欄で、時刻も設定できます(空欄=日付だけ)。ステータスのセルは、ステータスの色の点つきの一覧が開きます。列の見出しをドラッグすると、列の順序を入れ替えられます(タスク名の列も)。入る位置に線が出ます。順序はビューごとに保存され、あとから出した列は、末尾に入ります。列レイアウトとソートはセッションをまたいで保存されます:

表示メニューでフラット表示をオンにすると、フォルダや入れ子を無視して全タスクを1本のソート済みリストで表示します:

進捗列は、歯車メニューで進捗にチェックを入れると表示され、各タスクの進捗(progress の値、0〜100)を小さなバーとパーセントで示します。セルをダブルクリックするか、詳細パネルのスライダーで編集できます。

稲妻線(手順 2:表示メニューで稲妻線をオン。進捗列を表示しておくと、数値を線と見比べられます)は、今日を基準にした垂線を各タスクの実績到達点まで折り曲げた折れ線です。今日より左に折れれば遅れ、右なら進みを意味します。各行の点は、タスクの progress に対応するバー上の位置に置かれます(先週が期限なのに 40% のタスクは、線をその 40% 地点まで引き戻します)。100% のタスク、まだ開始日が来ていない未着手タスク、フォルダ行、ロールアップ中の親バーは今日線上を素通りします。開始日を過ぎているのに進捗 0% のタスクは、線を開始日まで引き戻します。線の色は設定 → Task Gantt Board → 稲妻線の色で変更できます。

バーのラベルを隠すと、各バーの後ろのタスク名と担当者を消して、すっきり見せられます(既定はオフ=名前を表示)。期限切れを強調(既定はオフ)は、期限日が過ぎていて、ステータスが完了・キャンセルでないタスクのバーを赤い枠で囲み、バーの後ろに ⚠ を付け、グループ見出しに赤い ⚠ の件数を出します。どちらも、表示オプションの行の稲妻線の右にあります。
ビュー
ボード(フォルダ)は、複数のビューを持てます。ツールバーの上に、Wrike のビューのようなタブとして並びます。ビューごとに、グループ化と色分け、「表示」メニューの切り替え、フィルタと一致条件、表示する列とその幅、並べ替え、ズーム、折りたたんだグループが保存されます。タブを切り替えると、見た目の設定がまとめて切り替わります。

- + でビューを追加します。今のビューをコピーは、すべての設定を複製して、元の隣に開きます。ガント・テーブル・カンバンは、既定の設定でフィルタのない新しいビューを追加します。列は、タイトル・開始・期限・担当者・ステータスから始まります。
- タブをドラッグすると、ビューの順序を入れ替えられます(入る位置に線が出ます)。順序は保存されます。
- タブをダブルクリックするか、開いているタブの ▾(または任意のタブの右クリック)から、ビューの名前の変更・複製・削除ができます。最後の 1 つは削除できません。ビューを削除しても、タスクは消えません。
- 変更は、開いているビューに自動で保存されます。保存済みのフィルタのプリセットは、全ビューで共有のままです。ボードを初めて開くときは、最初のビューが今の設定を引き継ぐので、最初は何も変わりません。
テーブルビュー
+ → テーブルで、テーブルのビューを追加できます。ガントの表から、タイムラインを外したもので、スプレッドシートのように、まとめて入力・編集できます。列、グループ、サブタスク、フィルタ、並べ替えは、ガントと同じです。以下の操作は、ガントの表でも使えます。

- セルの選択: セルをクリック、Shift+クリックやドラッグで範囲、矢印キーと Tab で移動します。Enter、F2、ダブルクリックで、セルを編集します。Esc で、選択を解除します。
- コピー&貼り付け: 選んだセルを、Ctrl/Cmd+C、X、V で、タブ区切りのテキストとして扱います。Excel、Google スプレッドシート、Wrike との間で、貼り合えます。1 つの値を範囲に貼ると、範囲全体に入ります。複数の値は、左上のセルから入ります。列ごとに、文字の読み方が決まっています。日付は表示形式(または ISO。
2026/11/02 09:30のように時刻も付けられます)、ステータスは名前、タグはカンマ区切り、進捗は60か60%、カスタムフィールドは種類どおりです。名前(タイトル)の列は、ノートの名前を変えます。テキストの 1 行目がファイル名になり、そのノートへのリンクも名前の変更に追従し、タイトルを空にすることはできません。同じフォルダに同じ名前のノートは作れないので、そのフォルダにすでにある名前は、変えずに飛ばします(何件かを知らせます)。フォルダが違えば、同じ名前にできます。表の下端を超える行は貼られず、何行かを知らせます。読み取り専用のセルは、飛ばします。 - フィル: 選んだ範囲の右下の小さな四角を、上か下にドラッグすると、選んだ値を、通った行にコピーします。名前(タイトル)の列は、フィルしません(同じフォルダに同じ名前のノートは作れないため)。別々のタイトルを貼り付けることは、できます。
- 消去: Delete か Backspace で、選んだセルを空にします(期間のように、空にできない列は、そのままです)。
- 集計: 2 セル以上を選ぶと、ボードの下に、件数と、数値なら合計・平均・最小・最大、日付なら最小・最大が出ます。
- 貼り付け・フィル・消去は、それぞれまとめて 1 回の取り消し(Ctrl/Cmd+Z)です。貼り付けとフィルは純粋なコピーです。日付は、元のとおりに書かれ、開始日を変えても期限は動かず、時刻も元のものになります。守るのは日付の決まりだけで、開始日だけのタスクは作らず(期限が空なら、開始日が入ります)、日付が逆転するときだけ、もう一方が合わせて動きます。依存している後続タスクは、日付を変えたときと同じく動きます。
- タスクの追加: テーブルの最下段の + タスクを追加 の行で、タスクを作ります(日付は設定の新規タスクの日付に従います)。詳細パネルは開かず、表のその場で、名前を入力できます。
- 行のドラッグ(移動・サブタスク化)は、名前のセルから始めます。ほかのセルからのドラッグは、範囲の選択になります。
カンバンビュー
+ → カンバンで、ガントのビューの隣に、カンバンのビューを追加できます。
Wrike のボードビューのように、ボードのタスクを、ステータスごとの列にカードとして並べます。列の名前と色は、ステータスのものです(設定でステータスを足すと、列が増えます)。列の順序は、最初は設定のステータスの順序です(新しいカンバンのビューが、その順序を一度だけ取り込み、以後は自分の順序を持ちます)。ステータスのないタスクは、未割当の列に入ります。未割当は、いつも先頭で、カードがあるあいだだけ表示されます。
-
カードを別の列へドラッグすると、タスクのステータスが、その列のステータスに変わります(Ctrl/Cmd+Z で取り消せます)。未割当にドロップすると、ステータスが外れます。
-
列の見出しをドラッグすると、列の順序を入れ替えられます。順序は、そのビューに保存されます(カンバンのビューごとに別の順序です)。設定が渡すのは、最初の順序だけです(ビューを最初に描くときに、一度だけ取り込みます)。あとから設定でステータスの順序を変えても(▲ ▼ ボタン。凡例の順序も変わります)、既存のビューは変わりません。設定でステータスを足すと、各ビューの列の末尾に増え、消すと、その列も消えます。
-
列の折りたたみ: 列の見出しの ⋯ に、この列を折りたたむ・空の列をすべて折りたたむ・すべての列を折りたたむ・すべての列を開くがあります。折りたたんだ列は、色・件数・名前だけの細い帯になり、クリックで開きます(カードを落とすこともできます)。折りたたみの状態は、そのビューに保存されます。

-
スイムレーン: ツールバーの左端のグループボタンで、ボードを担当者またはフォルダごとの横帯(レーン)に分けられます(なしで解除)。列の見出しは上に残り、どのレーンにも同じ列が並びます。レーンのタイトルをクリックすると、そのレーンを折りたたみます。カードを別の担当者のレーンへドラッグすると、ステータスに加えて担当者も書き換わります(取り消しは 1 回で両方戻ります)。別のフォルダのレーンへドラッグすると、そのフォルダへファイルが移動します(サブタスクも一緒に移り、親タスクとの関係は外れます。ステータスも変わる場合は、移動と合わせて取り消し 1 回で戻ります)。担当者のないタスクは未割当のレーン、ボードのフォルダ直下のタスクは**(直下)**のレーンに入ります。グループの設定と、折りたたんだレーンは、そのビューに保存されます。



-
カードの並べ替え: 列の中でカードを上下にドラッグすると、入る位置に線が出ます。別の列の好きな位置にドラッグすることもでき、その場合はステータス(担当者のレーンなら担当者も)も変わります。ドラッグすると、そのビューが手動の並びになり、そのビューに保存されます。ツールバーの並べ替えボタンで、手動と、列を選んだ昇順・降順を切り替えられ、ほかの並べ替えにしても手動の順序は残ります。手動の順序にまだ入っていないカードは、その列の末尾に入ります。ノートの名前変更や移動があっても、位置は保たれます。順序の変更は、取り消しの対象ではありません。

-
カードをクリックすると、詳細パネルが開きます。
-
カードの項目: カードには、タスク名と、既定で担当者・開始日・期限が出ます。カードボタン(ツールバーの左端、フォルダ名の左にある一覧のアイコン)から、ほかの列(カスタムフィールドを含む)を、チェックボックスで出せます。

-
タスクの追加: 列の見出しの +、または、カードの下の + タスクを追加 で、その列のステータスのタスクを作ります(未割当の列ではステータスなし。日付は設定の新規タスクの日付に従います)。カードの ⋯ メニュー(または右クリック)には、サブタスクを追加(親と同じフォルダに作ります)、フォルダへ移動…(サブフォルダのあるボードだけ。フォルダの一覧が開き、選ぶとサブタスクごとファイルが移り、親との関係は外れます。取り消せます)、削除があります。詳細パネルにも、ステータスの下に同じフォルダのドロップダウンがあります。

-
サブタスク: サブタスクのあるカードには、件数のアイコンが出ます。クリックすると、1 階層目のサブタスクが、親のカードと同じ項目つきで、カードの中に開きます。親が表示されているあいだ、サブタスクは独立したカードにはなりません。


-
フィルタとプリセットは、ガントのビューと同じように使えます。列の中のカードは、ビューの並べ替え(並べ替えボタン)か、手動の順序に従います。フィルタとカードの項目は、ほかのビューと同じく、ビューごとに保存されます。
-
ドラッグでサブタスクにする: カードを、別のカードの真ん中にドロップすると(枠が出ます。上下の端なら、これまでどおり前後への並べ替えです)、そのカードのサブタスクになります。表と同じく、親のフォルダへ移ります(取り消せます)。サブタスクを独立したカードに戻すには、親のカードの中でサブタスクを右クリックするか、カードの ⋯ メニューの親タスクから切り離すを使います。


カスタムフィールド
任意のフロントマターのキーを、テーブルの列として表示できます。設定 → Task Gantt Board → カスタムフィールドでフィールドを追加を押し、キー(フロントマターのプロパティ名。例: client)、列見出しに使う表示名(省略可)、種類を指定します。
- テキスト — そのまま表示します。リストの値はカンマ区切りで表示し、編集するとリストのまま書き戻します。
- 数値 — 右揃えで表示し、数値として並べ替えます。
- 日付 — 設定の日付形式で表示し、開始・期限と同じカレンダーで編集します(日付部分のみ)。

追加したフィールドの列はすぐに表示され、ほかの列と同じく歯車メニューで表示を切り替えられます。見出しのクリックで並べ替え、セルのダブルクリックで編集でき、編集はすべて取り消せます。詳細パネルにも、すべてのカスタムフィールドが、進捗と本文の間に出て、そこで編集できます(表の列を隠していても出ます)。カンバンのカードにも、歯車のメニューから出せます。キー名を変えても、列の表示・幅・並べ替えの設定はそのまま残ります。キーの変更は Enter を押すか入力欄を離れたときに反映され、旧キーの値を持つノートがあれば、ノート側のプロパティ名も変えるか(新しいキーに既に値があるノートは上書きしません)、列が読むキーだけを変えるかを尋ねます。プラグインが既に使っているキー(フロントマターのキー名にある開始・期限・ステータスなどのキーと tags)は使えません。また、同じキーのフィールドが複数あるときは最初の 1 つだけが列になります。どちらも設定画面に注意書きが出ます。

フィルタ
オプション行の下のフィルタ行でボードを絞り込めます。フィルタを追加から項目(名前/ステータス/ステータスグループ/担当者/タグ/フォルダ/開始日/期限日)を選び、条件を設定します。各フィルタはチップで表示され、クリックで編集、**×**で削除できます。
- 名前:と一致/以外/を含む/を含まない/で始まる/で終わる
- ステータス/ステータスグループ/担当者/タグ:複数値をチェックで選択((なし)=未設定も選べます)。と一致/以外/未設定/設定あり
- 開始日/期限日:プリセット(昨日・今日・明日)/具体的な日付/相対的な日付(例:1 週間後・毎日再計算)/期間と比較。と一致/より前/より後/以前/以後/未設定/設定あり
- フォルダ(ボードにサブフォルダがあるときに出ます):タスクのあるフォルダを、ボードからの相対パスで一覧にします。フォルダを選ぶと、その下のフォルダも含み、**(直下)**は、ボードのフォルダ直下のタスクです。どのビューでも使えるので、カンバンも、1 つのフォルダに絞り込めます。
- カスタムフィールド:設定で作ったフィールドが、フィルタを追加の一覧の最後に並び、種類ごとに絞り込めます。文字:と一致/以外/を含む/を含まない/で始まる/で終わる/未設定/設定あり(大文字小文字は区別しません。リストの値は、どれか 1 つでも当てはまれば一致し、「以外」「を含まない」は、どれも当てはまらないときに一致します)。数値:=/≠/>/</以上/以下/未設定/設定あり。日付:開始日・期限日と同じ選択肢。値のないタスクは、「未設定」以外の比較から外れます。カスタムフィールドを削除すると、そのフィールドのフィルタも消えます。

フィルタが2件以上あるときは、右端の 表示するタスク → すべてに一致(AND)/いずれかに一致(OR)で結合方法を選べます。
プリセット
プリセットからワンクリックでフィルタ構成を切り替えられます。組み込みプリセットは 日付なし(バーなし)/日付あり/期限切れ/未割り当て/完了済み/未完了。後ろの 2 つはステータス名ではなくステータスグループを見ます:完了済みは完了グループのタスク、未完了は完了でもキャンセルでもないタスク(アクティブ・延期・ステータス未設定)です。任意のフィルタ構成に名前を付けてプリセットとして保存でき、保存したプリセットは再適用・削除が可能です。フィルタをクリアで全解除。フィルタとプリセットはセッションをまたいで保存されます。

フォルダ間のタスク移動
フォルダでグループ化しているとき、タスク行をドラッグしてフォルダにドロップするとそのフォルダへ移動できます(別タスクへドロップすると、そのタスクと同じフォルダへ)。リンクは自動更新され、移動は Ctrl/Cmd+Z または取り消しボタンで元に戻せます。空のフォルダも行として表示されるので常にドロップ先になります(空フォルダを表示トグル=既定ON で切替)。
手動の並び順
タスク行を、別の行の上端か下端にドロップすると(入る位置に線が出ます)、その行の前・後ろに並べられます。行の真ん中なら、これまでどおりサブタスクになります。ビューが手動の並び順になり、ビューごとに保存されます(表示 → 手動の並び順で入り切りでき、列の見出しをクリックすると、その列の並べ替えに戻ります。保存した順序は残ります)。フォルダでグループ化しているときは、別のフォルダや別の親の行の隣に落とすと、そこへ移動もします(サブタスクも一緒です)。フラット表示や、ほかのグループ化では、順序だけが変わります。選ばないかぎり、手動の並びにはならず、日付順が既定のままです。順序の変更は、取り消しの対象ではありませんが、移動は、取り消せます。
サブタスク
タスクに parent(別タスクへの単一 wikilink)を与えると、表でその親の下に入れ子表示され、シェブロンで折りたたみできます。フォルダでグループ化中は、タスクを別タスクへドラッグするとサブタスク化(親のフォルダへサブツリーごと移動)、フォルダへドラッグすると親を解除してトップレベルへ戻します。循環は禁止され、移動はすべて取り消し可能です。ロールアップトグルで、親のバー(と開始・期限セル)を子孫全体の範囲として描けます。親の設定・解除は詳細パネルからも行えます。
タグ
タスクは Obsidian ネイティブの tags(フロントマター tags: +本文 #tag)を使うので、Obsidian の検索・タグペインと同期します。タグでグループ化すると、各タグの下にそのタスクが表示され(多値のタスクは複数グループに登場)、タグでの絞り込みや、チップ表示のタグ列も使えます。タグでグループ化中は、タスクをタグのグループへドラッグするとそのタグを付与できます(フォルダへのドロップ=移動とは別動作)。タグの追加・削除は詳細パネル、またはタグセルのダブルクリックで同じエディタを開いて行えます。どちらもフロントマターの tags: に書き込むため、本文中に書いた #tag は表示されますがここからは削除できません。
タグ・フォルダの色
タグの色はすべて タグの既定色 を土台にし、そこから個別に上書きします。既定色は 設定 → Task Gantt Board → タグの色 で指定でき、未設定なら Obsidian 本体のタグ色に従います。フォルダは従来どおり名前から自動で色が付きます。
フォルダの見出し・タグの見出し・タグのチップを右クリックして、色の変更/リセットができます。色を指定すると、そのタグが設定の個別のタグに登録され、リセットすると登録が外れます。つまり一覧には自分で色を決めたタグだけが並び、それ以外は既定色に従います。設定側からは Vault のタグを選んで追加でき、削除には確認が入ります(設定画面には取り消しが無いため)。並びはタグ名順です(フォルダの色は右クリックのみ)。
上で動画が再生されない場合は こちら からご覧ください。
タスクの作成
+ 新規タスクで現在のフォルダに日付付きノートを作り、すぐ名前を付けられます。もちろんそこから始める必要はありません。対象フォルダ内のノートは、まだ日付が無いものも含めてそのまま行として表示されるので、既存ノートをクリックして詳細パネルで 開始 / 期限 を入力すれば、そのままスケジュール付きタスクになります。各セルは値が空のままでもダブルクリックで編集できるので、表から直接入力しても構いません。
新規タスクは、既定で開始・期限とも作成日(今日)になります。設定 → Task Gantt Board → タスク作成時の設定の新規タスクの日付を**バックログ(日付なし)**に切り替えると、日付を入れずにノートを作り、あとからスケジュールできます。

タスクの書き方
各タスクは 1 つの Markdown ファイル。スケジュールはフロントマター、説明は本文に書きます。
---
start: 2026-02-04
end: 2026-02-07
status: in-progress
assignee: kato
progress: 40
after:
- "[[掃き掃除]]" # 先行タスク(依存=矢印)
---
# 拭き掃除
本文がタスクの説明(詳細パネルに表示)。
| フロントマター | 意味 |
|---|---|
start / end |
開始 / 終了日 YYYY-MM-DD(バーの位置と長さ)。YYYY-MM-DDTHH:mm+09:00 形式で時刻も設定可(詳細パネルで編集。オフセットはタイムゾーン設定に従う) |
status |
ステータス ID(設定で定義、バー色に反映。所属するステータスグループが完了済み/未完了フィルタの根拠) |
assignee |
担当者(バー脇にラベル表示) |
progress |
進捗 0–100(バー内の塗り。詳細パネルのスライダー、または進捗列のダブルクリックで編集) |
after |
先行タスクへの wikilink 配列(依存=矢印、違反は赤) |
milestone |
true で菱形(期間ゼロ) |
gcal |
true で Google カレンダー同期(後述)の対象にする(フラグ付きタスクのみ同期がオンのときだけ判定に使用) |
gcalId |
タスクを Google カレンダーへ Push すると自動で入る、紐付け先イベントの ID。手動編集不可 |
マイルストーン: end(終了日)だけがあり start(開始日)が無いタスクは、自動的にマイルストーンと判定され菱形で描画されます。milestone: true でも同じです。通常タスクに戻すには start(開始日)を与えてください。
タスク名はファイル名(拡張子なし)。グループは直上のサブフォルダ名。フロントマターのキー名は設定で変更できます。
examples/Cleaning Project お掃除プロジェクト/ に動作確認用のサンプルがあります(対象フォルダにそれを指定)。
依存関係
バーの丸ハンドルから別のバーへドラッグすると依存を作成します。つないだ端で種類が決まります:FS(終了→開始)・SS(開始→開始)・FF(終了→終了)。SS/FF の後続は、先行の日程変更に追従します。FS の後続は、先行が遅れて重なったときに後ろへ押し出されます。先行の期限日の次の稼働日へ移り、期間はそのまま保たれます。押し出しはその先の後続へも連鎖します。先行を前倒ししても後続は引き戻されないので、わざと空けた間隔は残ります。この動作は設定の FS の後続を自動で押し出す でオフにできます。マイルストーンは依存では動きません。線は、角を丸めた折れ線で描かれます。依存線をクリックで切断(Ctrl/Cmd+Z または取り消しボタンで戻せます)。輪になる依存(互いを待ち合うタスク)は、通知を出して作成しません。
期間(Duration)
期間列(歯車メニューで表示)は、タスクが何稼働日かかるかを表示します。両端の日を含めて数え、設定した休日(既定は土・日)は数えません。期間はどこにも保存されず、start と end から計算します(日付が常に正です)。
- 期間を変える(セルのダブルクリック、または詳細パネルの欄)と、開始日はそのままで期限日が動きます。開始日が無いタスクは今日から始まります。
- 開始日だけを変えると、期限日も一緒に動き、期間が保たれます(バーが平行移動します)。期限日を変えた場合は期間が変わります。タイムラインでバーの端をドラッグしたときは、これまでどおり伸び縮みします。
- FS 依存と組み合わせると 期間でスケジュールを組めます。各タスクに期間を入れて FS でつなげば、遅れたタスクがその後ろをまとめて押し出します。
PNG・PDF で書き出す
ツールバーのダウンロードボタン(または、ボードを開いているときにコマンドパレットの書き出しコマンド)から、形式と範囲を選びます。

| チャートのみ | 表とチャート | |
|---|---|---|
| PNG | タイムライン(日付軸とバー) | 表の表示中の列と、タイムライン |
| 同じ内容を A4 横のページに | 同じ内容を A4 横のページに |
書き出されるのは、今表示しているボードそのままです。絞り込み、グループ、折りたたみ、列、ズーム、テーマが反映され、画面外にスクロールした行も全部含まれます。上には表題(フォルダ名と今日の日付)が付きます。PDF は、ボードの幅を A4 横の幅に合わせて並べ、縦に長ければ行の境目で次のページに続けます。各ページには日付軸(と表の見出し)が付きます。ファイルは Vault の添付ファイルの置き場所に保存され、通知から開けます。とても大きなボードは、キャンバスの上限に収まるよう縮小されます。鮮明にしたいときは、絞り込むかグループを畳んでください。PDF はボードを画像として収めるので、文字は選択できません。


CSV の書き出し
同じメニュー(と、コマンドの 書き出し: CSV)から、表を CSV に書き出せます。今表示している列が見出しになり、今見えている行が、表示の順(絞り込み・並べ替え・グループ・折りたたみのまま)に 1 行ずつ並びます。値は、画面に表示されているとおりです(日付は表示形式、ステータスは名前、タグはカンマ区切り)。ファイルは、BOM 付きの UTF-8 です(Excel で日本語などが文字化けしません)。ほかの書き出しと同じく、添付ファイルの置き場所に保存します。テーブルビューでは、メニューに CSV だけが出ます。CSV の読み込み(インポート)はありません。

取り消し・やり直し
ボード上の変更は、Ctrl/Cmd+Z または取り消しボタンで元に戻し、Ctrl/Cmd+Shift+Z・Ctrl/Cmd+Y またはやり直しボタンでやり直せます。対象はセルの編集、詳細パネルのすべての項目(名前の変更・本文を含む)、バーのドラッグ、依存、移動・サブタスク化、タグ、タスクの作成・削除です。削除を取り消すと、ノートが同じ場所に作り直されます。一緒に動いた後続も、まとめて元に戻ります。テキスト入力中は、ショートカットは入力内容の取り消しとして働きます。ファイルエクスプローラーでボードのタスクやフォルダをリネーム・移動した場合も履歴に入るので、取り消しは常に起きた順に遡ります。履歴はボードを開いている間保持されます。
Obsidian の外で行った変更(Windows のエクスプローラーや macOS の Finder、同期ツールでのノートのリネーム・移動・削除)は履歴に入りません。Obsidian からは「ファイルが消えて、別のファイルが現れた」としか見えないためです。そうしたノートに対するそれ以前の変更を取り消しても、何も起きません。取り消せるようにしたい場合は、リネームや移動を Obsidian の中(タイトル欄や Obsidian のファイルエクスプローラー)で行ってください。
設定
設定 → Task Gantt Board から、既定フォルダ・サブフォルダの再帰・既定ズーム・日付の表示フォーマット(YYYY/MM/DD/DD/MM/YYYY/MM/DD/YYYY。保存値は常に ISO YYYY-MM-DD)を設定できます。
タイムゾーン設定(システム / 固定GMTオフセット・代表都市付き一覧)で時刻の表示・保存に使うタイムゾーンを選べます。変更すると保存済みの時刻が新しいオフセットに換算されて表示されます。

休日の曜日(土・日/金・土/日のみ/なし)は、期間の計算と依存による移動のときに数えません。FS の後続を自動で押し出す(既定はオン)で、先行の遅れを FS の後続へ伝えるかを切り替えます。
稲妻線の色設定で、表示オプションの稲妻線で描かれる折れ線の色を変更できます(既定の橙に戻すボタン付き)。
ステータスは自由に追加・編集・削除できます。各ステータスは id(フロントマターの status 値と対応)・ラベル・グループ・色(バー色に反映)を持ちます。
グループは「そのタスクが終わっているか」をプラグインが判断する唯一の根拠です。Wrike に倣った 4 種固定で、増やすことはできません:アクティブ(作業中)・完了(終了)・延期(保留・ブロック・待ち)・キャンセル(中止)。各ステータスはちょうど 1 つに属し、フィルタプリセットの完了済み/未完了はグループだけを見ます(ステータス名は見ません)。そのため リリース済み という名前でも、完了グループに入れておけば完了として扱われます。完了グループのステータスが 1 つも無い場合は設定画面に注意が出て、完了済みプリセットは常に 0 件になります。
2.8.x からの更新時:既存のステータスには、id とラベルからグループを一度だけ推測して設定します(
done/完了→ 完了、cancelled/中止→ キャンセル、on hold/blocked/保留→ 延期、それ以外 → アクティブ)。更新後に一覧を確認し、外れているものは直してください。
プラグインが読むフロントマターのキー名(start / end / status / assignee / after / progress / milestone)も、各自の Vault の慣習に合わせて変更できます。

通知(任意)
時刻を設定したタスクの開始・期限を、Incoming Webhook 経由で Discord / Slack / Microsoft Teams に通知できます。設定 → Task Gantt Board → 通知 で Webhook URL・対象(開始/期限)・通知タイミング(1週間前・1日前・1時間前・10分前・時刻ちょうど)を設定してください。テスト送信ボタンで Webhook の疎通をすぐ確認できます。
Teams はチャネルのワークフローを使います(チャネルの … メニュー → ワークフロー → テンプレート「Webhook 要求を受信したらチャネルに投稿する」→ 発行された URL を貼り付け)。廃止済みの Office 365 コネクタ URL には対応していません。現行の Power Automate Webhook を使い、メッセージは Adaptive Card として投稿されます。


- ネットワーク利用について:有効にすると、設定した Webhook URL に対してタスク名と日時のみを HTTP POST で送信します。それ以外の情報は送らず、他の宛先にも送信しません。URL を両方空欄(既定)にすればネットワークアクセスは一切行いません。
- 通知は Obsidian の起動中のみ動作します。終了中に過ぎたタイミングはスキップされ、同じ通知は二度送られません。
- 日付のみ(時刻なし)のタスクは通知対象外です。
- 対象は Vault 全体です。フォルダの設定は不要で、時刻を設定したタスクはすべて対象になります。
Google カレンダー同期(任意・デスクトップ専用)
タスクと Google カレンダーを双方向で同期できます。タスクの作成・日程変更・削除はイベントとして反映され、Google カレンダー側でのイベント移動・削除はタスクのフロントマターへ書き戻されます。設定 → Task Gantt Board → Google カレンダー で方向ごと(Push / Pull)に ON/OFF できます。
セットアップ
プラグインにはサーバーがないため、ユーザー自身の Google Cloud プロジェクトを使います。
- Google Cloud Console でプロジェクトを作成し、Google Calendar API を有効化する。
- OAuth 同意画面を設定(External で可)し、自分の Google アカウントをテストユーザーに追加する。アプリは自分専用の未確認アプリなので、同意時に「確認されていないアプリ」の警告が出ますが想定どおりです(そのまま続行してください)。
- OAuth クライアント ID(種類:デスクトップアプリ)を作成し、クライアント ID とシークレットをプラグイン設定に貼り付ける。
- 接続を押すとブラウザで Google の同意画面が開き、
127.0.0.1(ループバック)で認可を受け取ります。その後同期先カレンダーを選択してください(専用カレンダーの利用を推奨)。

同期の仕組み
- Pull(Google カレンダー→タスク)が対象にするのは、Task Gantt Board 自身が作成したイベントのみです。 Google カレンダー側で直接イベントを新規作成しても、それがタスクとして取り込まれることはありません。また、プラグインが関与していない既存イベントの編集・削除も無視されます — Pull は自分がPushしたイベントへの変更を読み戻すだけで、カレンダーに元からある予定には一切手を付けません。
- 既定ではフロントマターに
gcal: trueフラグを付けたタスクだけが同期されます(オプトイン。詳細パネルのトグルで切替でき、同期済みタスクには Google カレンダーで開く リンクも表示されます)。フラグ付きタスクのみ同期をオフにすると、対象フォルダ内の日付付きタスク全てが対象になります。 - 日付のみのタスクは終日イベント、両端に時刻のあるタスクは時刻付きイベント(プラグインのタイムゾーン設定を使用)、マイルストーンは1日のイベントになります。紐付け先イベントの ID はタスクの
gcalIdキーに自動で保存されます(手動編集は不可)。 - ローカルの編集は数秒で Push され、Google カレンダー側の変更は設定間隔(既定5分)で Pull されます。タイトルの同期はタスク→イベントの一方向のみで、イベント名を Google カレンダー側で変更しても次の Push でタスク名に戻ります(外部からのファイルリネームは危険なため)。
- 前回同期以降に両側が変更されていた場合は新しい方の編集が勝ち、どちらを採用したかを通知します。
- タスクを削除するとイベントも削除されます(設定で変更可)。Google カレンダー側でイベントを削除した場合、既定ではタスクの紐付けを解除するだけです(日付もクリアする設定あり)。ファイルが削除されることはありません。
- 繰り返しイベントは Push / Pull とも対象外です。
例:Test1 と Test2 は gcal: true を付けて Push され、イベントとして反映されています。Test3 (no flag) はフラグが無いためローカルのみに留まっています。一方 Test3 from GC と祝日「七夕」は Google カレンダー側で直接作られたもので、タスクとしては取り込まれていません:

開示事項
- ネットワーク利用について:接続すると Google の OAuth / Calendar API とのみ通信し、同期対象タスクの名前・日付・本文抜粋(先頭500文字)とノートへ戻るリンクを送信します。未設定(既定)の場合、ネットワークアクセスは一切行いません。
- アカウントと認証情報:Google アカウントと自身の Google Cloud OAuth クライアントが必要です。要求スコープは
calendar.eventsとcalendar.calendarlist.readonlyのみです。OAuth のクライアントシークレットとリフレッシュトークンは Obsidian のシークレットストレージ(OS のキーチェーン)に保存され、プラグインのdata.jsonには書き込まれません。そのため Vault の同期・バックアップ・git には含まれません。data.jsonに残るのはクライアント ID のみです。シークレットストレージは端末ごとの保存なので、端末ごとに接続し直してください。2.9.3 以前から更新すると、data.jsonに平文で残っていた値は自動で移行・削除されます。過去にdata.jsonを git へコミット・共有したことがある場合は、Google Cloud Console でクライアントシークレットを再発行し、接続し直してください。 - モバイルは非対応です(OAuth のループバック受信にデスクトップが必要)。他の機能は従来どおりモバイルでも動作します。
Vault へのアクセス
ボードを組み立てるため、プラグインは Vault 内の Markdown ファイルを一覧し、Obsidian のメタデータキャッシュを通してフロントマターを読み取ります。フォルダを開いたときに表示されるのはそのフォルダ配下のノートだけです。ただし、通知は Vault 全体を対象にし、カスタムフィールドのキー名を変えるときは全ノートからそのキーを探します。読み取った内容が端末の外へ出ることはありません。ネットワークを使うのは、上に書いた任意の通知と Google カレンダー同期だけです。
開発
npm install # 依存をインストール
npm run dev # 監視ビルド
npm run build # 型チェック+本番ビルド
npm test # ヘッドレスのモデルテスト
main.js / manifest.json / styles.css を <vault>/.obsidian/plugins/task-gantt/ にコピーして有効化。
設計
設計判断の経緯は docs/adr/(最新は ADR-0005)、用語は CONTEXT.md を参照。
既知の制限
自動スケジューリング(クリティカルパス)・時刻粒度・複数フォルダ横断は未実装。
ライセンス
MIT ライセンス(LICENSE を参照)。