### X-Read Command Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Provides a detailed example of the `/x-read` command, showing the type of analysis performed on a given X post URL.

```bash
/x-read https://x.com/garrytan/status/2048121438914154664
```

--------------------------------

### AI Preamble Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/references/ai-first-rules.md

Every note should start with a 'For future Claude' section summarizing its content, purpose, and any staleness caveats. This helps the AI quickly assess relevance.

```markdown
## For future Claude
This note is a [type] about [topic] saved on [date]. It [main purpose].
[Optional caveat about staleness, confidence, or scope.]
```

--------------------------------

### Clone Repository and Install Dependencies

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/CONTRIBUTING.md

Steps to clone the repository, navigate into the project directory, and install Python dependencies using uv. This sets up the local development environment.

```bash
git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/Projects/obsidian-second-brain
cd ~/Projects/obsidian-second-brain
uv sync
```

--------------------------------

### Install and Check yt-dlp

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/obsidian-ingest.md

Installs yt-dlp if not found, useful for fetching YouTube video metadata and transcripts.

```bash
which yt-dlp || brew install yt-dlp
```

--------------------------------

### Install Codex CLI / Gemini CLI / OpenCode

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/llms.txt

Clone the repository, build the desired CLI platform, and copy the distribution files to your Obsidian vault. Start the CLI from the vault root.

```bash
git clone https://github.com/eugeniughelbur/obsidian-second-brain
cd obsidian-second-brain
bash scripts/build.sh --platform codex-cli   # or gemini-cli, or opencode
cp -R dist/codex-cli/. /path/to/your/vault/
```

--------------------------------

### Obsidian Emerge Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Shows how `/obsidian-emerge` analyzes daily notes to identify recurring themes or bottlenecks across different projects.

```bash
/obsidian-emerge
```

--------------------------------

### Install Research Toolkit Dependencies

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Installs Python dependencies and sets up the .env file for API keys. Ensure you answer 'y' to the research prompt during installation or follow the manual steps.

```bash
mkdir -p ~/.config/obsidian-second-brain
cp .env.example ~/.config/obsidian-second-brain/.env
chmod 600 ~/.config/obsidian-second-brain/.env
# then paste keys into the file
uv sync   # installs Python deps
```

--------------------------------

### Obsidian Connect Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Demonstrates the `/obsidian-connect` command for finding intersections between disparate topics within the user's knowledge graph.

```bash
/obsidian-connect "distributed systems" "cooking"
```

--------------------------------

### Obsidian Challenge Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Illustrates how the `/obsidian-challenge` command uses AI to review user notes and provide context-aware feedback on proposed actions.

```bash
/obsidian-challenge
```

--------------------------------

### Obsidian Graduate Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Illustrates the `/obsidian-graduate` command, which uses AI to flesh out an idea into a full project specification with tasks and goals.

```bash
/obsidian-graduate
```

--------------------------------

### Install and Use Whisper for Audio Transcription

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/obsidian-ingest.md

Installs the Whisper ASR model if missing and then uses it to transcribe an audio file, outputting the result as plain text.

```bash
# Transcribe with Whisper (install if missing)
which whisper || pip install openai-whisper
whisper "path/to/audio.m4a" --model base --output_format txt --output_dir /tmp
```

--------------------------------

### Install for Codex CLI, Gemini CLI, or OpenCode

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Instructions for installing the Obsidian Second Brain for different CLI platforms. This involves cloning the repository, building the platform-specific distribution, and copying files to the vault directory.

```bash
git clone https://github.com/eugeniughelbur/obsidian-second-brain
cd obsidian-second-brain
bash scripts/build.sh --platform codex-cli   # or gemini-cli, or opencode
cp -R dist/codex-cli/. /path/to/your/vault/   # or .gemini-cli / .opencode/
```

--------------------------------

### X-Pulse Command Example Output

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Illustrates the structured output from the `/x-pulse` command for a given topic, including trending themes, voices, and post ideas.

```text
WHAT'S HOT (last 24-72h)
  1. Agentic AI vs Basic Automation — voices: @NVIDIAAP, @woisau1
  2. Self-Improving Sovereign Agents — voices: @tom_doerr, @AIDailyGems
  3. Control Layers & Execution Gaps — voices: @ZIQING_JP

WHAT'S UNDEREXPLORED
  - ROI numbers for non-developer small business users
  - Integration of digital agents with physical robotics

H শ্বHOOKS THAT ARE WORKING
  - "Automation executes. Autonomy reasons." — @NVIDIAAP

POST IDEAS FOR YOU TODAY
  1. Thread: "I gave an open-source agent its own GitHub repo and watched it self-improve"
  2. Single: "Automation executes. Autonomy reasons. Here's the control layer..."
```

--------------------------------

### Install Codex Wrappers

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Installs shim executables for Codex to allow running commands by name. These shims delegate to a script that wraps the command for `codex exec`.

```bash
bash scripts/install-codex-wrappers.sh
```

--------------------------------

### Configure API Keys for Research Toolkit

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/CONTRIBUTING.md

Instructions for setting up API keys for the research toolkit by copying the example environment file and setting appropriate permissions. This is necessary for specific research-related commands.

```bash
mkdir -p ~/.config/obsidian-second-brain
cp .env.example ~/.config/obsidian-second-brain/.env
chmod 600 ~/.config/obsidian-second-brain/.env
# then paste your xAI / Perplexity / YouTube keys into the file
```

--------------------------------

### Install and Bootstrap New Vault (One-line)

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

Installs the Obsidian Second Brain skill and bootstraps a new vault using a single command. It prompts for vault path, user name, and a preset configuration.

```bash
curl -sL https://raw.githubusercontent.com/eugeniughelbur/obsidian-second-brain/main/scripts/quick-install.sh | bash
```

--------------------------------

### Install Claude Code Skill

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/llms.txt

Clone the repository and run the setup script to install the Claude Code skill for your Obsidian vault.

```bash
git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/.claude/skills/obsidian-second-brain
bash ~/.claude/skills/obsidian-second-brain/scripts/setup.sh "/path/to/your/vault"
```

--------------------------------

### Obsidian Ingest Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Shows the `/obsidian-ingest` command for processing external content (like YouTube videos) and automatically updating the knowledge vault.

```bash
/obsidian-ingest https://youtube.com/watch?v=example
```

--------------------------------

### Research Command Examples

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Demonstrates various research commands for gathering and synthesizing information from the web and social media. Some commands require API keys for full functionality.

```bash
/x-read [url]
```

```bash
/x-pulse [topic]
```

```bash
/research [topic]
```

```bash
/research-deep [topic]
```

```bash
/notebooklm [topic]
```

```bash
/youtube [url]
```

```bash
/podcast [url]
```

--------------------------------

### Bi-temporal Facts Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

Demonstrates how to record historical facts with event and transaction times using the 'timeline' frontmatter array. This preserves history and provenance for each fact.

```yaml
timeline:
  - fact: "CTO at Single Grain"
    from: 2024-01-01            # event time: when it was true
    until: 2026-04-07
    learned: 2026-02-23         # transaction time: when the vault learned it
    source: "[[2026-02-23]]"    # where from
  - fact: "Architect at Single Grain"
    from: 2026-04-07
    until: present
    learned: 2026-04-07
    source: "[[2026-04-07]]"
```

--------------------------------

### Minimum Frontmatter Structure

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

Every note must include frontmatter. This example shows the minimum required fields: date and tags.

```yaml
---
date: 2026-03-24
tags:
  - <note-type>
---

```

--------------------------------

### Research Command Example Output

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Placeholder for the output of the `/research` command, which provides a synthesized dossier with citations.

```bash
/research "AI memory tools"
```

--------------------------------

### Stub Note Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/references/write-rules.md

Provides a minimal YAML frontmatter and heading structure for creating a stub note when a link target does not yet exist. This includes essential metadata and a placeholder for content.

```yaml
---
date: 2026-03-24
tags:
  - person    # or project, task, etc.
---

# Person Name

<!-- Note created as stub. Expand when more info is available. -->
```

--------------------------------

### Process YouTube Videos with /youtube

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use the `/youtube [url]` command to get a transcript, summary, and quotes from YouTube videos saved to your vault.

```Markdown
YouTube videos | Watch passively, forget | `/youtube [url]` transcript + summary + quotes saved to vault
```

--------------------------------

### Smoke Test a Python Command Locally

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/CONTRIBUTING.md

Example of running a specific Python command locally using uv to test its functionality. Requires API keys to be set up.

```bash
# Smoke test a command (requires API keys)
uv run -m scripts.research.x_read "https://x.com/some/post"
```

--------------------------------

### AI-First Rule: Rich Frontmatter Example

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/obsidian-synthesize.md

Notes must include rich frontmatter as per AI-first rules, specifying type, date, tags, and an ai-first flag.

```yaml
type: synthesis
date: YYYY-MM-DD
tags:
  - concept
  - synthesis
ai-first: true
```

--------------------------------

### Read X Thread with /x-read

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use the `/x-read [url]` command to get a post, thread, sentiment, and voices from an X thread.

```Markdown
Reading an X thread | Open X, scroll, screenshot, paste | `/x-read [url]` returns post + thread + sentiment + voices
```

--------------------------------

### Operation Log Entry - Logs Folder Exists

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/obsidian-visualize.md

Example of an operation log entry when the 'Logs/' directory exists. Appends to a dated log file within the 'Logs/' directory.

```markdown
**HH:MM** - visualize | Canvas generated - X nodes, Y edges, Z orphans
```

--------------------------------

### Make Background Agent Hook Executable

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

Sets execute permissions on the background agent script. This is a one-time setup step required before the agent can run.

```bash
chmod +x ~/.claude/skills/obsidian-second-brain/hooks/obsidian-bg-agent.sh
```

--------------------------------

### Quick Install Claude Code

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

A single command to quickly install the Claude Code version of the Obsidian Second Brain. This is the default installation method.

```bash
curl -fsSL https://raw.githubusercontent.com/eugeniughelbur/obsidian-second-brain/main/scripts/quick-install.sh | bash
```

--------------------------------

### NotebookLM Synthesis Process

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Demonstrates the workflow for using NotebookLM to synthesize information from the vault using Gemini. It involves scanning the vault, uploading relevant notes, and generating a grounded synthesis.

```bash
/notebooklm "AI-first vault rule"

Vault baseline: 12 notes
Model: gemini-2.5-flash
Uploading 12 notes... done
Asking Gemini, grounded against the uploaded sources...

=== SAVED ===
Research/NotebookLM/2026-05-15 - ai-first-vault-rule.md
```

--------------------------------

### Load Session Context with /world

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use the `/world` command to load full session context quickly.

```Markdown
Session continuity | Re-explain every time | `/world` loads full context in 10 seconds
```

--------------------------------

### Bootstrap Additional Vaults

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

This Python script bootstraps a new vault. Use it for additional vaults after the initial global setup.

```python
python scripts/bootstrap_vault.py --path ~/vaults/repo-b --name "Your Name"
```

--------------------------------

### Make Validator Script Executable

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

This command makes the AI-first validator script executable. It's a one-time setup step.

```bash
chmod +x ~/.claude/skills/obsidian-second-brain/hooks/validate-ai-first.sh
```

--------------------------------

### Web Research with /research

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use the `/research [topic]` command to get a sourced dossier with recency markers for web research.

```Markdown
Web research | Open 12 tabs, copy quotes manually | `/research [topic]` returns a sourced dossier with recency markers
```

--------------------------------

### Headless Command Execution (Correct)

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

Shows the reliable pattern for headless runs (cron, launchd). It points Claude at the command file and instructs it to execute the steps within.

```bash
# Right - read the command file and execute its steps:
cd "$VAULT" && claude --dangerously-skip-permissions \
  -p "Read ~/.claude/commands/obsidian-daily.md and carry out its instructions exactly."
```

--------------------------------

### Bootstrap Vault with Builder Preset

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use this command to initialize a new vault with a specific preset, such as 'builder'. The path and name can be customized.

```bash
python bootstrap_vault.py --path ~/my-vault --name "Your Name" --preset builder
```

--------------------------------

### Operation Log Entry - No Logs Folder

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/obsidian-visualize.md

Example of an operation log entry when the 'Logs/' directory does not exist. Appends to a 'log.md' file in the vault root.

```markdown
## [YYYY-MM-DD] visualize | Canvas generated — X nodes, Y edges, Z orphans
```

--------------------------------

### Update to Latest Version

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Navigate to the project directory and pull the latest changes from the repository.

```bash
cd ~/.claude/skills/obsidian-second-brain && git pull
```

--------------------------------

### Execute NotebookLM Research

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/notebooklm.md

Run the notebooklm script from the repository root to perform source-grounded research on a specified topic. Ensure the GEMINI_API_KEY is configured.

```bash
uv run -m scripts.research.notebooklm --topic "<topic>"
```

--------------------------------

### Find Patterns with /emerge

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use the `/emerge` command to find patterns by re-reading notes.

```Markdown
Finding patterns | Re-read dozens of notes | `/emerge` finds them for you
```

--------------------------------

### Bootstrap Vault in Assistant Mode

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/SKILL.md

Use this command to initialize a new Obsidian vault for assistant mode, specifying the vault path, user name, assistant mode, and the subject's name.

```bash
python scripts/bootstrap_vault.py --path ~/my-vault --name "Your Name" --mode assistant --subject "Boss Name"
```

--------------------------------

### Propagation Rule Examples

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/references/write-rules.md

Illustrates the ripple effects of creating or updating notes by tracing forward to identify other notes that need to be informed. This ensures consistency and interconnectedness across the vault.

```text
New project created
  → Add card to kanban board (Backlog column)
  → Link from today's daily note
  → If it has a person involved, link from their note

Task completed
  → Move card in kanban (to ✅ Done, with strikethrough)
  → Update project note (Recent Activity or Delivered section)
  → Log in today's daily note

Person note updated
  → If interaction happened today, log in daily note
  → If they made a mention/shoutout, add to Mentions Log

Dev log created
  → Link from project note (Recent Activity section)
  → Link from today's daily note (Work / Work Log section)

Decision made
  → Log in project note (Key Decisions section)
  → Log in today's daily note

Deal moved forward
  → Update deal file (status, probability, notes)
  → Update Side Biz kanban board
  → Reflect in daily note
```

--------------------------------

### Suggest Time for Event Creation

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/commands/obsidian-schedule.md

Use this mode to find and book an available time slot for an event linked to a task. The command suggests time slots within a specified window and prompts the user to select one before creating the event.

```bash
/obsidian-schedule task:onboarding-call suggest:next-week 45min
```

--------------------------------

### Analyze X Trends with /x-pulse

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/README.md

Use the `/x-pulse` command to scan X for hot themes, gaps, hooks, and post ideas.

```Markdown
Knowing what to post | Guess what's trending | `/x-pulse` scans X and returns hot themes + gaps + hooks + post ideas
```

--------------------------------

### Define Trigger Phrases in YAML Frontmatter

Source: https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/CONTRIBUTING.md

Example of defining English trigger phrases within the YAML frontmatter of a command's markdown file. This is used for multilingual support.

```yaml
---
description: Save everything worth keeping from this conversation to the vault
category: vault
triggers_en: ["save this", "save the conversation", "save to vault", "obsidian save"]
---
```