Task Gantt

Task Gantt

English | 日本語

An interactive project-management Gantt 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.

Requires Obsidian 1.13.0 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

1. In Settings → Task Gantt, set the target folder (e.g. Projects/Cleanup).
2. 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.
3. Direct subfolders become groups, and the .md files inside them become tasks.
4. Drag a bar / resize its edges to write the new dates back to that file's start/end frontmatter. You can also double-click a Start/Due cell in the table to pick a date from a calendar.
5. Click a task in the table — or double-click its bar — to slide in a detail panel (dates, status, assignee, progress, body) from the right.
6. 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.
7. 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 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.

Group by folder, status, or assignee, and color by status or assignee (with a legend). Filters narrow the board to a single status or assignee:

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

Choose columns with the gear button — show or hide Start, Due, Assignee, and Status. The column layout and sort are remembered across sessions:

Flat view lists every task in one sorted list, ignoring folders and nesting:

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.

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.

Coloring tags and folders

Tags and folders get an automatic color from their name, and you can override it. Right-click a folder heading, a tag heading, or a tag chip to change or reset its color. Tag colors can also be set in Settings → Task Gantt → Tag colors (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.

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).

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. Click a dependency line to remove it (undo with Ctrl/Cmd+Z or the undo button).

Settings

Open Settings → Task Gantt 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.

Statuses are fully customizable — add, edit, or delete them. Each status has an id (matches the status frontmatter value), a label, and a color reflected in the bar.

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 can post reminders for tasks that have a time of day to Discord and/or Slack via incoming webhooks. In Settings → Task Gantt → 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 webhook instantly.

• 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.

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. Custom-field columns are planned.

License

MIT — see LICENSE.

---

日本語

English | 日本語

プロジェクト管理ツールのようなタスク管理 UI を Obsidian で実現するプラグインです。1 ファイル = 1 タスクとし、指定フォルダ配下を 「表＋タイムライン」ガントで表示・編集します。バーのドラッグで日程変更、依存の作成、マイルストーン、ソート・フィルタ、ドラッグでのフォルダ移動などができます。

Obsidian 1.13.0 以降が必要です。

スクリーンショット

左列のリボンボタン、またはフォルダの右クリック →**「Open as Gantt」**から Gantt として開きます：

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

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

使い方

1. 設定 → Task Gantt で対象フォルダを指定（例: Projects/お掃除）。
2. 左列の 「Gantt を開く」リボンアイコン（またはコマンド「Gantt を開く」）でビューを開く。リボンは、現在開いているノートのフォルダ（またはエクスプローラで選択中のフォルダ）を Gantt 表示し、どちらも無ければ設定の既定フォルダ（未設定なら Vault ルート）を開きます。フォルダを右クリック →**「Open as Gantt」**でも開けます。
3. 直下のサブフォルダがグループ、その中の .md がタスクになります。
4. バーをドラッグ／端をリサイズすると、そのファイルの start/end に書き戻します。表の開始・期限セルをダブルクリックすると、カレンダーから日付を選べます。
5. 表のタスクをクリック、またはバーをダブルクリックすると、右から詳細パネル（日付・ステータス・担当者・進捗・本文）がスライドインします。
6. ＋ 新規タスクボタンで現在のフォルダに1日タスクを作ってその場で命名、今日ボタンでタイムラインを今日へスクロールできます。
7. Day / Week / Month / Fit ボタンで時間軸の拡大率を変更。Fit はペイン幅に自動で収め、リサイズにも追従します。

UI 表示は Obsidian の表示言語に追従します。対応言語：英語・日本語・韓国語・中国語（簡体／繁体）・フランス語・スペイン語・ロシア語（その他は英語にフォールバック）。

表示オプション

表の上のオプション行で、ボードの見せ方を調整できます。

グループ化（フォルダ／ステータス／担当者）と色分け（ステータス／担当者・凡例付き）。フィルタで特定のステータス・担当者に絞り込めます：

ソートは列ヘッダをクリック。もう一度クリックで昇順／降順を切替（↑/↓）：

列の表示は歯車ボタンから、開始・期限・担当者・ステータスを出し分け。列レイアウトとソートはセッションをまたいで保存されます：

フラット表示は、フォルダや入れ子を無視して全タスクを1本のソート済みリストで表示します：

フォルダ間のタスク移動

フォルダでグループ化しているとき、タスク行をドラッグしてフォルダにドロップするとそのフォルダへ移動できます（別タスクへドロップすると、そのタスクと同じフォルダへ）。リンクは自動更新され、移動は Ctrl/Cmd+Z または取り消しボタンで元に戻せます。空のフォルダも行として表示されるので常にドロップ先になります（空フォルダを表示トグル＝既定ON で切替）。

サブタスク

タスクに parent（別タスクへの単一 wikilink）を与えると、表でその親の下に入れ子表示され、シェブロンで折りたたみできます。フォルダでグループ化中は、タスクを別タスクへドラッグするとサブタスク化（親のフォルダへサブツリーごと移動）、フォルダへドラッグすると親を解除してトップレベルへ戻します。循環は禁止され、移動はすべて取り消し可能です。ロールアップトグルで、親のバー（と開始・期限セル）を子孫全体の範囲として描けます。親の設定・解除は詳細パネルからも行えます。

タグ

タスクは Obsidian ネイティブの tags（フロントマター tags: ＋本文 #tag）を使うので、Obsidian の検索・タグペインと同期します。タグでグループ化すると、各タグの下にそのタスクが表示され（多値のタスクは複数グループに登場）、タグでの絞り込みや、チップ表示のタグ列も使えます。タグでグループ化中は、タスクをタグのグループへドラッグするとそのタグを付与できます（フォルダへのドロップ＝移動とは別動作）。タグの追加・削除は詳細パネルからも行えます。

タグ・フォルダの色

タグとフォルダは名前から自動で色が付き、上書きもできます。フォルダの見出し・タグの見出し・タグのチップを右クリックして、色の変更／リセットができます。タグの色は 設定 → Task Gantt → タグの色 からも指定できます（フォルダの色は右クリックのみ）。

上で動画が再生されない場合は こちら からご覧ください。

タスクの作成

＋ 新規タスクで現在のフォルダに日付付きノートを作り、すぐ名前を付けられます。もちろんそこから始める必要はありません。対象フォルダ内のノートは、まだ日付が無いものも含めてそのまま行として表示されるので、既存ノートをクリックして詳細パネルで 開始 / 期限 を入力すれば、そのままスケジュール付きタスクになります。

タスクの書き方

各タスクは 1 つの Markdown ファイル。スケジュールはフロントマター、説明は本文に書きます。

---
start: 2026-02-04
end: 2026-02-07
status: in-progress
assignee: kato
progress: 40
after:
  - "[[掃き掃除]]"     # 先行タスク（依存＝矢印）
---

# 拭き掃除
本文がタスクの説明（詳細パネルに表示）。

マイルストーン： end（終了日）だけがあり start（開始日）が無いタスクは、自動的にマイルストーンと判定され菱形で描画されます。milestone: true でも同じです。通常タスクに戻すには start（開始日）を与えてください。

タスク名はファイル名（拡張子なし）。グループは直上のサブフォルダ名。フロントマターのキー名は設定で変更できます。

examples/Cleaning Project お掃除プロジェクト/ に動作確認用のサンプルがあります（対象フォルダにそれを指定）。

依存関係

バーの丸ハンドルから別のバーへドラッグすると依存を作成します。つないだ端で種類が決まります：FS（終了→開始）・SS（開始→開始）・FF（終了→終了）。SS/FF の後続は、先行の日程変更に追従します。依存線をクリックで切断（Ctrl/Cmd+Z または取り消しボタンで戻せます）。

設定

設定 → Task Gantt から、既定フォルダ・サブフォルダの再帰・既定ズーム・日付の表示フォーマット（YYYY/MM/DD／DD/MM/YYYY／MM/DD/YYYY。保存値は常に ISO YYYY-MM-DD）を設定できます。

タイムゾーン設定（システム / 固定GMTオフセット・代表都市付き一覧）で時刻の表示・保存に使うタイムゾーンを選べます。変更すると保存済みの時刻が新しいオフセットに換算されて表示されます。

ステータスは自由に追加・編集・削除できます。各ステータスは id（フロントマターの status 値と対応）・ラベル・色（バー色に反映）を持ちます。

プラグインが読むフロントマターのキー名（start / end / status / assignee / after / progress / milestone）も、各自の Vault の慣習に合わせて変更できます。

通知（任意）

時刻を設定したタスクの開始・期限を、Incoming Webhook 経由で Discord / Slack に通知できます。設定 → Task Gantt → 通知 で Webhook URL・対象（開始/期限）・通知タイミング（1週間前・1日前・1時間前・10分前・時刻ちょうど）を設定してください。テスト送信ボタンで Webhook の疎通をすぐ確認できます。

• ネットワーク利用について：有効にすると、設定した Webhook URL に対してタスク名と日時のみを HTTP POST で送信します。それ以外の情報は送らず、他の宛先にも送信しません。URL を両方空欄（既定）にすればネットワークアクセスは一切行いません。
• 通知は Obsidian の起動中のみ動作します。終了中に過ぎたタイミングはスキップされ、同じ通知は二度送られません。
• 日付のみ（時刻なし）のタスクは通知対象外です。
• 対象は Vault 全体です。フォルダの設定は不要で、時刻を設定したタスクはすべて対象になります。

開発

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 を参照）。