Task Dock

VS Code 内でタスクをローカル管理できる拡張機能です。データはすべて手元の SQLite ファイルに保存されるため、外部サービスへの登録や通信は不要です。

Features

• カンバンボード — Todo / In Progress / Review / Done の 4 列でドラッグ＆ドロップ管理。全列が等しい高さのドロップ領域を持つ
• タスク一覧（テーブルビュー） — テーブル形式でタスクを一覧表示。シングルクリックで選択、ダブルクリックで詳細を開く
• カテゴリ管理 — カテゴリ単位でタスクを整理。アーカイブ済みカテゴリは一覧・詳細画面で視覚的に区別
• サブタスク — タスクを階層構造で管理
• Close / Archive — タスクを削除せずに完結・保管。履歴を DB に残したまま一覧から除外
• 複数 DB 対応 — 複数の SQLite ファイルを同時に開いてそれぞれ独立して操作
• 読み取り専用モード — DB への誤書き込みを防ぐロック機能
• 自動更新 — DB ファイルの変更を検知して自動リフレッシュ。手動の ↺ ボタンも常時表示
• パネル再利用 — 同じタスク・カテゴリを再度開いた場合は既存タブをフォーカス（重複タブを作らない）
• AI タスク生成 — 自然言語からタスクを自動生成（Anthropic API キーが必要）

クイックスタート

インストールしてから最初のタスクを作るまでの手順です。

1. DB（データファイル）を作成する

タスクデータはローカルの SQLite ファイルに保存します。まず最初にこのファイルを作成します。

1. VS Code 左下のステータスバーに表示された DB 名 をクリック
2. 「新しい DB を作成」 を選択
3. 保存先とファイル名を指定して作成

DB とは？ タスクデータを保存するファイルです（例: mytasks.sqlite3）。プロジェクトごとや用途ごとに複数作成できます。

2. カテゴリを作成する

カテゴリはタスクを分類するグループです（例:「開発」「レビュー」「個人」）。

1. 左サイドバーの Task Dock アイコン をクリック
2. All Projects ビューに作成した DB が表示される
3. DB を右クリック → 「このDBにタスクを作成」 からでもタスク作成可能
4. カテゴリはタスク作成時に合わせて作成されます

3. タスクを作成する

1. All Projects ビューでカテゴリを右クリック → 「このカテゴリにタスクを作成」
2. タイトル・優先度・期日などを入力して作成

4. カンバンボードで管理する

カテゴリをクリックするとテーブルビューが開き、上部の Board ボタンでカンバンボードに切り替えられます。

• Todo / In Progress / Review / Done の 4 列でタスクを管理
• カードをドラッグ＆ドロップでステータス変更
• タスクが少ない列でも列全体がドロップ領域になる

詳細な使い方

サイドバー

アクティビティバーの Task Dock アイコンをクリックすると 2 つのビューが表示されます。

• My Tasks — 自分にアサインされたタスク一覧（後述の設定が必要）。サイドバーアイコンとセクション名横に未完了タスクの総数を表示
• All Projects — 全 DB・カテゴリ・タスクの階層ツリー。カテゴリ名横に未完了タスク数を (N) 形式で表示

My Tasks の設定

My Tasks には、担当者（Assignee）が自分のユーザー ID と一致するタスクが表示されます。タスク作成時に Assignee が自動的に設定されます。

表示するタスクを絞り込むには、VS Code の設定でユーザー ID を指定します。

設定方法:

1. Ctrl+, で設定を開く
2. Task Dock: User Id を検索
3. 自分のユーザー ID を入力（例: alice、john.doe など）

または settings.json に直接記述：

{
  "taskDock.userId": "alice"
}

デフォルトは system です。変更しない場合、担当者未設定の全タスクが My Tasks に表示されます。

DB の管理

左下ステータスバーの DB 名をクリックすると DB 操作メニューが開きます。

All Projects ツリーの DB ノードには アンマウントボタン（⊘） が表示されます。確認ダイアログ付きで安全にアンマウントできます。

タスク操作

パネル再利用: 同じタスクやカテゴリを複数回開いても、既存タブがフォーカスされるだけで重複タブは開きません。

Close / Archive ワークフロー

タスクは削除せずに状態で管理します。

Todo / In Progress / Review
        ↓
      Done  ────→  Archive（保管）
        ↓
      Close（理由必須）  ────→  Archive

• Close: タスク詳細の「Close Task」ボタンから実行。理由の入力が必須です。
• Archive: Done または Close 済みのタスクを対象に実行。リストビューの Done / Close タブでタスクを選択し、右上の「Archive」ボタンから一括実行できます。
• Archive したタスクは一覧の Archive タブで確認できます。

カテゴリのアーカイブ

カテゴリ（プロジェクト）単位でアーカイブできます。

• 条件: カテゴリ内の全タスクが Done またはアーカイブ済みであること
• 方法: テーブルビュー右上の Archive Category ボタン
• 表示: アーカイブ済みカテゴリはサイドバーに アーカイブアイコン＋「アーカイブ済み」ラベルで表示。テーブルビューでも「▪ アーカイブ済み」バッジを表示し、編集ボタンは無効化される
• サイドバー上部の Archive フィルターボタン でアーカイブ済みカテゴリを表示切り替えできます

自動更新

テーブルビューとカンバンボードは DB ファイルの 更新時刻（mtime）を監視し、変更があったときのみデータを再取得します（最大 20 秒間隔）。DB が静止している間はほぼ無負荷です。共有 DB を複数人で使用している場合に有効です。手動更新は右上の ↺ ボタンから実行できます。

タスクを Edit 中は自動更新を一時停止するため、ネットワーク共有上の DB でも保存操作が競合しません。

自分に新たにタスクがアサインされた場合は VS Code の通知でお知らせします。

DB テーブルビュー

サイドバーの DB ノードをクリックすると、その DB 内の全カテゴリ・タスクをテーブル形式で表示します。

• カテゴリ行をシングルクリック → 開閉
• カテゴリ行をダブルクリック → そのカテゴリのテーブルビューへ移動

AI タスク生成

自然言語でタスク内容を入力すると、AI がタイトル・優先度・期日・タグを自動生成します。

事前準備: Anthropic の API キーが必要です。DB の connector_settings テーブルに connector_id = 'ai' のレコードとして API キーを登録してください。

コマンドパレット（Ctrl+Shift+P）→ Task Dock: Create Task from AI で起動します。

Requirements

• Visual Studio Code 1.100.0 以降
• Windows x64 のみ対応（Mac / Linux は今後対応予定）

Privacy

すべてのタスクデータはローカルの SQLite ファイルにのみ保存されます。外部への送信は一切ありません。

AI タスク生成機能を使用する場合のみ、入力したテキストが Anthropic の API サーバー に送信されます。API キーはご自身で取得・管理してください。

All task data is stored locally in SQLite files only and is never transmitted externally. When using the AI task generation feature, the text you enter is sent to Anthropic's API servers.

Known Issues

• 複数 PC 間でのタスク同期には未対応です。
• AI タスク生成の API キー設定は現在手動での DB 操作が必要です。

Release Notes

最新の変更履歴は CHANGELOG.md を参照してください。

0.6.0

• My Tasks ソート修正 — 複数 DB 環境で Sort by Priority / Deadline が正しく機能するように修正
• 編集中の保存失敗を修正 — ネットワーク共有の SQLite で編集中に自動更新と競合して保存できなかった問題を修正。Edit ボタン押下中は自動更新を停止
• 自動更新を mtime ベースに変更 — DB ファイルの更新時刻を確認し、変更がない場合は SQL を実行しない
• 自動更新間隔を 20 秒に延長 — 変更検知が軽量なため間隔を広げても体感差なし
• 重複更新ガード — 前回のリフレッシュ完了前に次が始まらないよう制御。ネットワーク遅延時の競合を防止
• 通知チェックを独立タイマーに分離 — 新規アサイン通知を 60 秒ごとの別タイマーに移動し UI リフレッシュと干渉しない

0.5.0

• タスク数バッジ — MY TASKS アイコンに全 DB 横断の自己アサインタスク数を表示。カテゴリ名横にも残タスク数を (N) 形式で表示
• My Tasks が全 DB を参照 — 複数 DB から自己アサインタスクを集約して表示
• 新規アサイン通知 — 自分に新たにタスクが割り当てられると VS Code 通知でお知らせ
• Assignee 自動入力 — タスク作成時に taskDock.userId を Assignee へ自動セット
• 自動更新間隔を短縮 — 10 秒ごとに自動リフレッシュ
• ネットワーク共有対応 — ネットワークドライブ上の DB の安定性を改善

0.4.0

• Review ステータス追加 — 旧 Blocked を Review に変更。カンバンボード・テーブル・ツリー全体を更新
• カテゴリアーカイブ改善 — アーカイブ済みカテゴリを視覚的に区別（アイコン＋バッジ）。テーブルビューで操作ボタンを無効化
• カテゴリアーカイブ条件緩和 — Done ステータスのタスクがあってもアーカイブ可能に
• パネル再利用 — 同じタスク・カテゴリを再度開いた場合は既存タブをフォーカス
• 自動更新 — 30 秒ごとに自動リフレッシュ＋手動の ↺ ボタン
• カンバン D&D 改善 — タスクが少ない列でも列全体がドロップ領域に
• タスク一覧 UX 改善 — シングルクリックで選択、ダブルクリックで詳細を開く
• タスク編集 Cancel ボタン — 変更を破棄して詳細画面に戻る
• タスク作成画面の統一 — タスク作成画面のレイアウトを編集画面と統一
• DB アンマウントボタン — ツリービューの DB ノードにアンマウントボタンを追加（確認ダイアログ付き）

0.3.0

• Close / Archive ワークフロー — タスクを削除せずに Close・Archive で状態管理
• 一括 Archive — Done / Close タブでタスクを選択して右上ボタンから一括実行
• DB アンマウント — コマンドパレットまたはテーブルビューから DB 接続を安全に解除
• タスク詳細画面の改善 — Edit / Close Task / Archive ボタンを右上に固定

0.2.0

• My Tasks — 担当者（Assignee）が自分の userId と一致するタスクを自動表示
• カンバンカード表示改善 — 優先度・期日・担当者をカードに表示
• 優先度ラベルを英語統一 — Low / Medium / High / Critical
• DB テーブルビューのタイトル — 開いている DB 名をパネルタイトルに表示

0.1.0

• マルチ DB 対応（複数 SQLite ファイルの同時マウント）
• カンバンボード（カンバン / リスト切り替え）
• DB テーブルビュー（カテゴリ開閉、ダブルクリックでボード遷移）
• サブタスク対応
• 読み取り専用モード
• AI タスク生成