Skip to main content
command CX Codex

obsidian-person — Claude Code command: what it does, how to install

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.

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

The command uses the obsidian-second-brain skill. It reads _CLAUDE.md at the vault root, searches for a matching note with fuzzy name handling, and asks for confirmation before changing an existing record. When no match is found, it creates Full Name.md in the entities folder resolved through references/folder-map.md: wiki/entities/ or People/.

It derives a person’s role, company, context, relationship strength, and last interaction date from the conversation. The interaction is added to today’s daily note, and an existing People index is updated. Notes must follow references/ai-first-rules.md, including frontmatter, [[wikilinks]], preserved sources, and confidence levels. If that rules file cannot be read, the command must stop before writing, so check it first.

What it helps with

  • find a person note from a partial name
  • update contact details from a conversation
  • create a person note in the mapped vault folder
  • log an interaction in today’s daily note
  • keep the People index current

Example prompts for the agent

  • Run /obsidian-person Anna Petrova and save the person details from our conversation.
  • Use /obsidian-person Alex Smith, show possible matches, and wait for confirmation before editing.
  • Run /obsidian-person Maria Ivanova and create the note if no match exists.

How to install obsidian-person

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

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

Questions about obsidian-person

How do I install obsidian-person in Claude Code?

Run /plugin marketplace add eugeniughelbur/obsidian-second-brain, then /plugin install obsidian-second-brain@obsidian-second-brain. The command file is .claude/commands/obsidian-person.md.

What does obsidian-person do?

It searches for or creates a person note from the conversation, fills in contact context, and logs the interaction in the daily note.

What does obsidian-person require before writing a note?

The vault must provide references/ai-first-rules.md. The command uses it for frontmatter, links, source handling, and confidence levels.

Source text

obsidian-person.md · MIT
---
description: Create or update a person note from conversation context
category: vault
trigger-mode: proactive
triggers_en: ["save this person", "add person", "new contact note", "create person note"]
triggers_de: ["diese Person speichern", "Person hinzufügen", "neue Kontaktnotiz", "Personennotiz erstellen"]
triggers_es: ["guarda a esta persona", "añade una persona", "nueva nota de contacto", "crea una nota de persona"]
triggers_pt: ["salve esta pessoa", "adicione uma pessoa", "nova nota de contato", "crie uma nota de pessoa"]
triggers_zh: ["保存这个人的信息", "新建联系人笔记", "为这个人建档", "更新这个人的资料"]
---

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

The argument is a person's 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 note matching the name (fuzzy - handle typos and partial names)
3. If found: confirm with user, then update with new info from conversation
4. If not found: create `Full Name.md` in the entities folder (resolved per `references/folder-map.md` - wiki-style `wiki/entities/`, Obsidian-style `People/`) with full frontmatter schema
5. Fill in everything inferable from the conversation: role, company, context, relationship strength, last interaction date
6. Log the interaction in today's daily note
7. If a People index file exists, add or update the entry there

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-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-board 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. 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-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