Skip to main content
command CX Codex

obsidian-board-hygiene — Claude Code command: kanban triage

obsidian-board-hygiene identifies stale and overdue cards across Obsidian kanban boards to reschedule, archive, or close them in a single guided pass.

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-hygiene does

This command performs bulk triage on kanban boards within an Obsidian vault. It begins by reading _CLAUDE.md to locate the boards directory and determine kanban conventions, including the @{date} syntax. It parses open items across every column and calculates task age against today's date. The command categorizes items into overdue entries, stale cards sitting past the 14-day threshold, and unscheduled tasks lacking date tags.

For every item flagged, the agent proposes a single action accompanied by a brief rationale. Choices include marking a task completed with strikethrough styling, assigning a new date, shifting it to an archive section, or retaining it in place. Changes apply directly to the markdown file only after user confirmation, followed by an audit entry logged inside Logs/YYYY-MM-DD.md or log.md.

The routine expects the obsidian-second-brain skill and references/ai-first-rules.md to be present. In board files, the heading ## For future agent is strictly forbidden because the Obsidian Kanban plugin would render it as a ghost column.

What it helps with

  • clear overloaded columns on an Obsidian kanban board
  • surface overdue items and cards untouched for over 14 days
  • batch reschedule, drop, or finish tasks under explicit review
  • record board cleanup actions into daily vault logs

Example prompts for the agent

  • /obsidian-board-hygiene Projects
  • Triage overdue cards on my sprint board
  • Run board hygiene on Backlog

How to install obsidian-board-hygiene

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-hygiene.md

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

Questions about obsidian-board-hygiene

How to install obsidian-board-hygiene in Claude Code?

First run /plugin marketplace add eugeniughelbur/obsidian-second-brain, then execute /plugin install obsidian-second-brain@obsidian-second-brain. Alternatively, place the command into .claude/commands/obsidian-board-hygiene.md.

What does obsidian-board-hygiene do?

It scans an Obsidian kanban board for outdated task markers, tabulates the bloat per column, and generates a review batch to archive, postpone, or complete tasks in place.

Does this command permanently delete tasks from the board?

No, modifications are strictly additive. Tasks receive strikethroughs or move to archive headers, and the agent never commits changes without your explicit approval.

Source text

obsidian-board-hygiene.md · MIT
---
description: Bulk-triage a kanban board - surface stale items and archive, reschedule, or mark them done in one pass
category: vault
triggers_en: ["clean up my board", "triage my board", "board hygiene", "archive stale tasks", "my board is a mess"]
triggers_de: ["mein Board aufräumen", "mein Board priorisieren", "Board-Pflege", "veraltete Aufgaben archivieren", "mein Board ist ein Chaos"]
triggers_es: ["limpia mi tablero", "haz triaje de mi tablero", "ordena el tablero", "archiva las tareas viejas", "mi tablero es un desastre"]
triggers_pt: ["limpe meu board", "faça a triagem do meu board", "higiene do board", "arquive tarefas paradas", "meu board está uma bagunça"]
triggers_zh: ["整理我的看板", "清理过期任务", "帮我归档看板上的旧任务", "我的看板太乱了", "批量梳理看板"]
---

Use the obsidian-second-brain skill. Execute `/obsidian-board-hygiene [board]`:

The board's "This Week" column has quietly become a graveyard - this clears it. The board equivalent of the wanted-notes triage: surface what's stale, then keep / reschedule / done / archive in one guided pass.

1. Read `_CLAUDE.md` first if it exists in the vault root, to find the boards folder and kanban convention (columns, priority markers, `@{date}` format).
2. Read the target board (fuzzy-match the argument; if none given, list boards and ask). Parse every open item per column, extract its `@{date}` if present, and compute age vs today.
3. Group the open items by staleness: **overdue** (`@{date}` in the past), **stale** (in the same column with a date older than N days, default 14), and **undated** (no `@{date}` - can't be scheduled, flag separately). Show counts per column so the bloat is visible at a glance.
4. For each stale/overdue item, propose ONE verdict with a one-line reason: **done** (looks completed elsewhere - move to Done with strikethrough), **reschedule** (still real - set a new `@{date}` or move to Backlog/Next Week), **archive** (dead - move to an `_archived` section or Done with a "dropped" note), or **keep** (genuinely active, leave it). Present as a batch the user can approve, edit, or override - never auto-move destructively without confirmation.
5. Apply the approved verdicts to the board in place (additive moves + strikethrough, never silent deletion), then report what moved where and append a one-line entry to the operation log the operation log (`Logs/YYYY-MM-DD.md` if the vault uses a `Logs/` folder - create today's file if needed - else `log.md`).

A board only means something if "This Week" means this week. Run this whenever a column stops being trustworthy; pairs with `/obsidian-board` (which only flags) by actually clearing the backlog.

---

**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 →
idea-discovery idea-discovery surfaces 3–5 next-direction candidates by reading ungraduated ideas, open project questions, and orphan research notes in your Obsidian vault. CX Codex +1 ★ 5,412repo stars obsidian-challenge The obsidian-challenge command for Claude Code compares a plan with your Obsidian vault history to find past errors, risks, and contradictions. CX Codex +1 ★ 5,412repo stars obsidian-panel obsidian-panel is a Claude Code command that gathers independent views on a decision and synthesizes them for reviewing disputed questions in an Obsidian vault. CX Codex +1 ★ 5,412repo stars x-read x-read — a command that performs deep analysis of X (Twitter) posts or threads using Grok. Extracts the original text, thread chain, key claims, reply sentiment, and notable voices in the conversation. CX Codex +1 ★ 5,412repo stars vault-deep-synthesis The vault-deep-synthesis command reads every vault note tied to a topic and produces a synthesis of agreements, conflicts, aging claims, and unanswered questions. CX Codex +1 ★ 5,412repo stars obsidian-daily obsidian-daily — a command that automatically creates or updates your daily note in Obsidian, pulling in calendar events, overdue tasks, and context from your conversation. CX Codex +1 ★ 5,412repo stars obsidian-emerge obsidian-emerge surfaces hidden themes, emotional patterns, and unspoken conclusions across recent Obsidian vault notes. CX Codex +1 ★ 5,412repo stars obsidian-graduate The obsidian-graduate command for Claude Code turns an idea note into a project spec, tasks, kanban cards, and links. It moves a loose concept toward an execution plan. CX Codex +1 ★ 5,412repo stars

Project sponsors

Companies that keep this analytics open