Skip to main content
command CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain
Open on GitHub

What 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-brain

2Manually: put the files in place

.claude/commands/obsidian-board.md

Call it with /obsidian-board. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for Notes, tasks and projects →

From the same set51

The whole set →
obsidian-second-brain obsidian-second-brain — a skill for Claude Code that maintains an Obsidian vault as an evolving knowledge base. It activates for note searches and edits, vault upkeep, and new vault setup. CX Codex +1 543installs obsidian-task The obsidian-task command places a task on the right Obsidian kanban board and infers its priority and due date. Use it to capture tasks from a request or recent conversation. CX Codex +1 ★ 5,412repo stars obsidian-log obsidian-log logs your current development session into an Obsidian vault. It figures out the project from conversation context and formats notes for agent retrieval. CX Codex +1 ★ 5,412repo stars obsidian-person obsidian-person creates or updates a person note from conversation context, then records the interaction in the vault. Useful for keeping contact notes current in Obsidian. CX Codex +1 ★ 5,412repo stars obsidian-capture obsidian-capture — a command to save thoughts into Obsidian without friction. Your idea lands in the Ideas folder, and a mention goes into today's daily note. CX Codex +1 ★ 5,412repo stars obsidian-find obsidian-find searches an Obsidian vault and delivers relevant excerpts with context instead of bare filenames. CX Codex +1 ★ 5,412repo stars obsidian-project Creates or updates an Obsidian project note, then links it to a board and the daily note. It fits vaults that track projects through structured notes. CX Codex +1 ★ 5,412repo stars obsidian-review obsidian-review — a command that generates a structured report of work completed over a week or month by reading daily notes, logs, projects, and task completion data from your Obsidian vault. CX Codex +1 ★ 5,412repo stars

Project sponsors

Companies that keep this analytics open