Skip to main content
command CX Codex

obsidian-project — Claude Code command: projects, install

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.

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

The command searches the vault for an exact or approximate project name, including likely typos. When it finds a match, it shows the result and asks for confirmation before editing it. When no match is found, it creates Project Name.md in the folder resolved through references/folder-map.md, fills in details from the conversation, and places a card in 📥 Backlog or 🔨 In Progress.

The note follows the project schema from references/ai-first-rules.md, with project status, dates, tags, related people and projects, and ai-first: true where applicable. The command also links the project from today’s daily note. It reads _CLAUDE.md at the vault root before making changes when that file exists.

The rules require inline source URLs, [[wikilinks]] for referenced entities, and explicit handling of unknown facts instead of invented details. If references/ai-first-rules.md cannot be read, the command must report that before writing the note.

What it helps with

  • create a structured project note
  • find a project despite a typo
  • update project goals and status
  • put a project on the kanban board
  • link the project to today’s note

Example prompts for the agent

  • Run /obsidian-project Website launch and create the project from our conversation.
  • Use /obsidian-project database migration to search for close matches and ask before editing one.
  • Update /obsidian-project Internal portal with the latest details and link it from today’s note.

How to install obsidian-project

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

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

Questions about obsidian-project

How do I install obsidian-project in Claude Code?

Add the marketplace with /plugin marketplace add eugeniughelbur/obsidian-second-brain, then install the plugin with /plugin install obsidian-second-brain@obsidian-second-brain. The command file is .claude/commands/obsidian-project.md.

What does obsidian-project do?

It creates or updates a project note, adds a card to 📥 Backlog or 🔨 In Progress, and links the project from the daily note for today.

How does it handle an approximate project name?

It searches for a close match, shows what it found, and asks for confirmation. It should not silently create a note under a misspelled name.

Source text

obsidian-project.md · MIT
---
description: Create or update a project note - adds to board and daily note automatically
category: vault
triggers_en: ["new project", "create project note", "project setup", "start a project"]
triggers_de: ["neues Projekt", "Projektnotiz erstellen", "Projekt einrichten", "ein Projekt starten"]
triggers_es: ["nuevo proyecto", "crea una nota de proyecto", "configura el proyecto", "arranca un proyecto", "crea un proyecto nuevo"]
triggers_pt: ["novo projeto", "crie uma nota de projeto", "configuração de projeto", "inicie um projeto"]
triggers_zh: ["创建一个新项目", "新建项目笔记", "开始这个项目", "为项目建立基本结构"]
---

Use the obsidian-second-brain skill. Execute `/obsidian-project $ARGUMENTS`:

The argument is a project name. Handle typos and partial matches.

1. Read `_CLAUDE.md` first if it exists in the vault root
2. Search the vault for an existing project matching the name (fuzzy - handle typos)
3. If found: show what was found, confirm with user, then update with new info from conversation
4. If not found: create `Project Name.md` in the projects folder (resolved per `references/folder-map.md` - wiki-style `wiki/projects/`, Obsidian-style `Projects/`) with the full `type: project` schema from `references/ai-first-rules.md` (`type: project`, `date`, `updated`, `status: active`, `tags: [project]`, `related-people`, `related-projects`, optional `job`, `ai-first: true`)
5. Fill in everything inferable from the conversation: description, goals, key people, current status
6. Add a card to the relevant kanban board in the `📥 Backlog` or `🔨 In Progress` column
7. Link from today's daily note

If the name has a typo or is approximate, search the vault, show what was found, and confirm before proceeding. Never silently create a note with a misspelled name.

---

**AI-first rule:** Every note created or updated by this command MUST follow `references/ai-first-rules.md` - `## For future agent` preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`, plus type-specific fields), recency markers per external claim, mandatory `[[wikilinks]]` for every person/project/concept referenced, sources preserved verbatim with URLs inline, and confidence levels where applicable. 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. The vault is for future agent retrieval - not human reading.

**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-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-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 obsidian-recap obsidian-recap summarizes Obsidian vault activity for today, the week, or the month. It uses parallel subagents to process daily notes, dev logs, and kanban tasks into a structured recap. CX Codex +1 ★ 5,412repo stars obsidian-recurring obsidian-recurring is a command that tracks recurring payments or obligations in Obsidian and calculates the next due date. It links tasks to a board, project note, and log. CX Codex +1 ★ 5,412repo stars obsidian-reindex obsidian-reindex refreshes the semantic search index for an Obsidian vault and reports how many notes are indexed before and after. Runs fast on subsequent calls because it only embeds new or modified notes. CX Codex +1 ★ 5,412repo stars

Project sponsors

Companies that keep this analytics open