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.7.2 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. Every column the table can show is editable in place — just double-click the cell. Start and Due open a calendar, 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, 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.
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):

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

Choose columns with the gear button — show or hide Start, Due, Progress, Assignee, Status, and Tags. Any column shown here can be edited by double-clicking its cell. The column layout and sort are remembered across sessions:

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

Progress 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 → Progress line color.

Filters

A filter row below the options narrows the board. Click Add filter and pick a field — Name, Status, Assignee, Tag, 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 / Assignee / Tag let you tick several values — including (none) for unset — with is / is not / is empty / is not empty.
• 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.

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, and Unassigned. 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.

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

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).
assignee	Assignee (label shown next to the bar).
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. 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.

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

Google Calendar sync (optional, desktop only)

Task Gantt 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 → Google Calendar.

Setup

The plugin has no server, so it uses your own Google Cloud project:

1. In Google Cloud Console, create a project and enable the Google Calendar API.
2. 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.
3. Create an OAuth client ID of type Desktop app, and paste the client ID and secret into the plugin settings.
4. 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 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: true flag 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 gcalId frontmatter 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.events and calendar.calendarlist.readonly scopes. The OAuth refresh token, client ID, and secret are stored in plain text in the plugin's data.json inside your vault — treat that file accordingly (be careful when the vault itself is synced or shared).
• Mobile is not supported (the OAuth loopback needs a desktop); other features work on mobile as usual.

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.7.2 以降が必要です。

スクリーンショット

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

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

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

使い方

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

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

表示オプション

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

グループ化（フォルダ／ステータス／担当者）と色分け（ステータス／担当者・凡例付き）：

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

列の表示は歯車ボタンから、開始・期限・進捗・担当者・ステータス・タグを出し分け。ここに出せる列はすべてセルのダブルクリックで編集できます。列レイアウトとソートはセッションをまたいで保存されます：

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

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

フィルタ

オプション行の下のフィルタ行でボードを絞り込めます。フィルタを追加から項目（名前／ステータス／担当者／タグ／開始日／期限日）を選び、条件を設定します。各フィルタはチップで表示され、クリックで編集、**×**で削除できます。

• 名前：と一致／以外／を含む／を含まない／で始まる／で終わる
• ステータス／担当者／タグ：複数値をチェックで選択（（なし）＝未設定も選べます）。と一致／以外／未設定／設定あり
• 開始日／期限日：プリセット（昨日・今日・明日）／具体的な日付／相対的な日付（例：1 週間後・毎日再計算）／期間と比較。と一致／より前／より後／以前／以後／未設定／設定あり

フィルタが2件以上あるときは、右端の 表示するタスク → すべてに一致（AND）／いずれかに一致（OR）で結合方法を選べます。

プリセット

プリセットからワンクリックでフィルタ構成を切り替えられます。組み込みプリセットは 日付なし（バーなし）／日付あり／期限切れ／未割り当て。任意のフィルタ構成に名前を付けてプリセットとして保存でき、保存したプリセットは再適用・削除が可能です。フィルタをクリアで全解除。フィルタとプリセットはセッションをまたいで保存されます。

フォルダ間のタスク移動

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

サブタスク

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

タグ

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

タグ・フォルダの色

タグの色はすべて タグの既定色 を土台にし、そこから個別に上書きします。既定色は 設定 → Task Gantt → タグの色 で指定でき、未設定なら Obsidian 本体のタグ色に従います。フォルダは従来どおり名前から自動で色が付きます。

フォルダの見出し・タグの見出し・タグのチップを右クリックして、色の変更／リセットができます。色を指定すると、そのタグが設定の個別のタグに登録され、リセットすると登録が外れます。つまり一覧には自分で色を決めたタグだけが並び、それ以外は既定色に従います。設定側からは Vault のタグを選んで追加でき、削除には確認が入ります（設定画面には取り消しが無いため）。並びはタグ名順です（フォルダの色は右クリックのみ）。

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

タスクの作成

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

タスクの書き方

各タスクは 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 の後続は、先行の日程変更に追従します。依存線をクリックで切断（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 全体です。フォルダの設定は不要で、時刻を設定したタスクはすべて対象になります。

Google カレンダー同期（任意・デスクトップ専用）

タスクと Google カレンダーを双方向で同期できます。タスクの作成・日程変更・削除はイベントとして反映され、Google カレンダー側でのイベント移動・削除はタスクのフロントマターへ書き戻されます。設定 → Task Gantt → Google カレンダー で方向ごと（Push / Pull）に ON/OFF できます。

セットアップ

プラグインにはサーバーがないため、ユーザー自身の Google Cloud プロジェクトを使います。

1. Google Cloud Console でプロジェクトを作成し、Google Calendar API を有効化する。
2. OAuth 同意画面を設定（External で可）し、自分の Google アカウントをテストユーザーに追加する。アプリは自分専用の未確認アプリなので、同意時に「確認されていないアプリ」の警告が出ますが想定どおりです（そのまま続行してください）。
3. OAuth クライアント ID（種類：デスクトップアプリ）を作成し、クライアント ID とシークレットをプラグイン設定に貼り付ける。
4. 接続を押すとブラウザで Google の同意画面が開き、127.0.0.1（ループバック）で認可を受け取ります。その後同期先カレンダーを選択してください（専用カレンダーの利用を推奨）。

同期の仕組み

• Pull（Google カレンダー→タスク）が対象にするのは、Task Gantt 自身が作成したイベントのみです。 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 のリフレッシュトークン・クライアント ID・シークレットは Vault 内の data.json に平文保存されます。Vault 自体を同期・共有している場合はご注意ください。
• モバイルは非対応です（OAuth のループバック受信にデスクトップが必要）。他の機能は従来どおりモバイルでも動作します。

開発

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