Deck

Obsidian Deck

Deck puts your tasks, calendar and notes on one dashboard, so the moment you open Obsidian you can see where today stands. A dashboard is a .dashboard file made of widgets you can add, reorder and resize.

Widgets

Kanban cards dropped into the AI移譲 column can be handed to Claude Code, which works on the task in your vault and writes a log of what it did (desktop only).

Install

1. In Obsidian, open Settings → Community plugins and turn off Restricted mode if it is on.
2. Select Browse, search for Deck, then Install and Enable.

To install by hand, copy main.js, manifest.json and styles.css from a release into <vault>/.obsidian/plugins/deck-dashboard/.

Getting started

1. Run Deck: Open home dashboard from the command palette, or click the dashboard icon in the ribbon. The first time, it creates Home.dashboard from a template.
2. Widgets that need a folder you have not set yet say so and offer an Open settings button. Set the folders in Settings → Deck and the dashboard redraws.
3. Turn on Open the home dashboard on startup if you want it every time Obsidian starts.

Use ⚙ on a widget to edit it, ✎ for edit mode (drag to reorder, change width and height), and + ウィジェット追加 to add widgets.

Settings

Settings → Deck starts with the home dashboard and the folders widgets read. Each folder field suggests existing folders as you type.

A folder written in a widget's own settings (⚙) wins over these. Folders already written in an existing .dashboard file are kept as they are.

Upgrading from 0.0.x: if the plugin already had saved data, the folders that older versions used without asking are kept, so your dashboards keep working. You can change them in Settings → Deck.

Folder tokens in Dataview queries

Counter and Dataview widgets replace these tokens with the folders from Settings → Deck, so one dashboard works in any vault:

LIST FROM "{{taskFolder}}" WHERE status != "完了"

{{taskFolder}}, {{meetingFolder}} and {{dailyFolder}} are supported. While a folder used by a query is not set, the widget asks you to set it instead of querying the whole vault.

Task notes

Kanban, Gantt, Charts, Task creator and Sheets sync read task notes from their frontmatter. The field names follow the plugin's original Japanese schema:

---
status: 作業中      # Kanban column; 完了 = done
期限: 2026-11-30    # due date
優先度: High        # priority
PJT: Website        # project (Gantt groups, charts)
工数: 2h            # effort, used for the Gantt bar length
---

Kanban and Gantt let you change the status field, the columns and the other field names in each widget's settings. Subfolders of the task folder (Tasks/alice/…) are treated as members and shown as tabs.

Commands

• Create new dashboard
• Open home dashboard
• Reset home dashboard to template
• Add widget to active dashboard
• Toggle dashboard edit mode
• メールを開く (Gmail)
• Google Calendar: Authenticate / setup credentials, Sign out, List calendars
• Sheets Sync: Setup personal / org sheet, Sync now, Show status, Toggle auto-sync

Network use and privacy

Deck does not collect analytics or telemetry. It only connects to a service when you use the feature that needs it:

Google OAuth uses a client you create yourself in Google Cloud. Requested scopes: calendar.readonly, spreadsheets, drive.file, gmail.modify. Google sign-in and Claude Code are available on desktop only.

What is stored where

• Credentials (the Google OAuth client, Google tokens, the Anthropic API key and registered calendar addresses): on Obsidian 1.11.4 and later they are kept in Obsidian's secret storage (the device keychain), not in the vault folder. Values saved by older versions are moved there the first time they are used. Secret storage is not synced with the vault, so on another device you may need to sign in to Google or enter the API key again. On older Obsidian versions, or when secure storage is not available, they stay in data.json in plain text.
• <vault>/.obsidian/plugins/deck-dashboard/data.json: settings and the Sheets sync configuration (spreadsheet IDs). Keep this file out of public repositories and shared vaults all the same.
• .dashboard files: each widget's settings. A private iCal address works like a password, so register it in Settings → Deck → Calendars and refer to it by name; a URL pasted directly into a widget is saved inside the .dashboard file, where anyone you share or sync it with can read it. Registered addresses are kept with the credentials above.
• AI delegation logs and Sheets sync logs are written as notes in the folders you choose.

Development

See DEVELOPMENT.md.

License

MIT