obsidian-board — Claude Code command: kanban from Obsidian
obsidian-board — a command that displays a kanban board from your Obsidian vault, flags overdue tasks, and updates it directly from your conversation. Use it to manage projects stored in Obsidian while working in Claude Code.
MIT ★ 5,412 updated 2026-10-24
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brainWhat obsidian-board does
The /obsidian-board command reads your board from the boards/ folder, shows its current state: columns, task counts, and items past their @{date} deadline. If you don't name a specific board, the command lists available ones and asks which to open.
Once displayed, it offers to make updates. Describe what to change in conversation — move a task, add a new one, mark something done — and the command updates the board. Completed items move to the ✅ Done column with strikethrough. Dates are tagged with @{date} syntax; overdue items and in-progress tasks that haven't moved in over a week get flagged.
The command uses fuzzy matching to find boards by name and understands both Obsidian-style paths (Boards/) and wiki-style (boards/). It reads _CLAUDE.md from the vault root first if present, to pick up any vault-specific settings.
What it helps with
- Display current kanban state from your Obsidian vault
- Spot overdue and stalled tasks at a glance
- Update the board based on what you say in the conversation
- Move finished tasks to Done with strikethrough
- Find the right board when you have several, using partial names
Example prompts for the agent
- Show my board
- Update the kanban: move the auth task to In Progress
- Find the task about the API on my boards, show it, and mark it done
How to install obsidian-board
1Plugin marketplace
/plugin marketplace add eugeniughelbur/obsidian-second-brain/plugin install obsidian-second-brain@obsidian-second-brain2Manually: put the files in place
.claude/commands/obsidian-board.mdCall it with /obsidian-board. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/obsidian-board.mdCall it with /prompts:obsidian-board. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/obsidian-board.prompt.mdManually: put the files in place
.gemini/commands/obsidian-board.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about obsidian-board
How do I install obsidian-board in Claude Code?
Run these two commands in order: /plugin marketplace add eugeniughelbur/obsidian-second-brain, then /plugin install obsidian-second-brain@obsidian-second-brain. After that, /obsidian-board will be ready to use.
What does obsidian-board do?
It reads kanban boards stored in your Obsidian vault and lets you update them through Claude Code. It shows tasks grouped by column, highlights overdue items, and syncs changes when you describe them in conversation.
How does the command detect overdue or stalled tasks?
Tasks include dates in the @{date} format. Overdue items are those with a date in the past. In-progress tasks that haven't moved for more than a week are also flagged.
Source text
obsidian-board.md · MIT
---
description: Show or update a kanban board - flags overdue items, updates from conversation
category: vault
triggers_en: ["show board", "kanban", "what is on my board", "update board"]
triggers_de: ["zeige mein Board", "Kanban", "was ist auf meinem Board", "Board aktualisieren"]
triggers_es: ["muestra el tablero", "kanban", "qué hay en mi tablero", "actualiza el tablero", "cómo va mi tablero"]
triggers_pt: ["mostre o board", "kanban", "o que está no meu board", "atualize o board"]
triggers_zh: ["打开我的看板", "看看看板上有什么", "更新看板", "查看任务看板"]
---
Use the obsidian-second-brain skill. Execute `/obsidian-board $ARGUMENTS`:
The optional argument is a board name. Handle typos and partial matches.
1. Read `_CLAUDE.md` first if it exists in the vault root
2. If a board name is given, search the boards folder for it (fuzzy match), resolved per `references/folder-map.md` (wiki-style `boards/`, Obsidian-style `Boards/`)
3. If no name given, list available boards and ask which one
4. Read and display the current board state: columns, item counts, overdue items (past `@{date}`)
5. Ask if the user wants to make updates - if yes, infer changes from conversation context
6. Move completed items to ✅ Done with strikethrough, add new items in the right column
7. Flag any items that are overdue (past their `@{date}`), and any in-progress items whose `@{date}` is more than a week past. The board format has no per-column timestamps, so date stamps are the only age signal - do not guess column dwell time
---
**AI-first rule:** Board files follow the kanban exception in `references/ai-first-rules.md`: `kanban-plugin` frontmatter, NO `## For future agent` heading (the plugin would render it as a phantom column). Every NON-board note this command creates or updates (task notes, project notes) MUST follow the full rule - preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`), `[[wikilinks]]`, sources verbatim. If that path does not resolve from your working directory, search upward for it; if you still cannot read it, say so before writing rather than producing a note that silently skips the rule.
**Anti-fabrication:** Search exhaustively before claiming any note, person, or file is absent - false absence is the most common failure mode - and never invent facts, entities, or dates (mark unknowns as `TBD`). See the anti-fabrication and search-completeness hard rules in `references/ai-first-rules.md`.
© Eugeniu Ghelbur · MIT · eugeniughelbur/obsidian-second-brain