Skip to main content
skill CX Codex

obsidian-daily — Claude Code skill: what it does, how to install

Connects the agent to Obsidian daily notes through the official CLI: create or append entries, read a given day, search the vault.

MIT 102 installs ★ 7 updated 2026-08-06

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bastos/skills --skill obsidian-daily -a claude-code
Open on GitHub

What obsidian-daily does

The skill hands the agent the official obsidian command. It opens today's note, builds it from the template when the file is missing, adds a line at the bottom, reads any day you name and greps the vault. Builds exist for Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.

Relative dates are resolved before anything is called. Ask for “last Friday” or “3 days ago” and the skill runs date, falling back to BSD syntax on macOS, then feeds the YYYY-MM-DD result into the path. A vault is picked by putting vault="Work" in front of the subcommand. Search can return JSON with format=json when something downstream needs to parse it.

Obsidian 1.12+ has to be installed, with Command line interface switched on under Settings > General. Without it obsidian version fails and nothing else runs. Fresh notes land in the vault root using the YYYY-MM-DD date format — a custom folder means editing the paths in read commands yourself.

What it helps with

  • append a task to today's note without switching apps
  • read the entry from last Friday using a relative date
  • search vault content for a term
  • log timestamped lines through the day
  • drop a link into today's note with one command

Example prompts for the agent

  • Append - [ ] buy groceries to today's daily note.
  • Read the note from last Friday and summarize it.
  • Search the vault for meeting and return the results as JSON.

How to install obsidian-daily

1Skills CLI (Vercel)

npx skills add bastos/skills --skill obsidian-daily -a claude-code

2Manually: put the files in place

~/.claude/skills/obsidian-daily/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/obsidian-daily/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about obsidian-daily

How do I install obsidian-daily in Claude Code?

Run npx skills add bastos/skills --skill obsidian-daily -a claude-code. The skill file lands at ~/.claude/skills/obsidian-daily/SKILL.md.

What does obsidian-daily do?

It creates and opens Obsidian daily notes, appends entries, tasks and links, reads the note for a chosen day and searches vault content, all through the official CLI.

Which Obsidian version do I need?

Obsidian 1.12 or newer, with Command line interface enabled in Settings > General. A quick check: obsidian version should answer.

Source text

SKILL.md · MIT
---
name: obsidian-daily
description: Manages Obsidian Daily Notes via the official Obsidian CLI. Creates and opens daily notes, appends entries (journals, logs, tasks, links), reads daily notes and vault files, searches vault content, and handles relative dates like "yesterday", "last Friday", and "3 days ago". Requires Obsidian 1.12+ with Command line interface enabled.
metadata:
  author: github.com/bastos
  version: "2.0"
---

# Obsidian Daily Notes

Interact with Obsidian Daily Notes through the official `obsidian` command: create
or open today's note, append entries, read notes, and search vault content.

## Setup

Check that the official CLI is available:

```bash
obsidian version
```

If the command is unavailable, ask the user to enable Obsidian's CLI:
1. Install or update to Obsidian 1.12 or newer.
2. Open **Settings > General**.
3. Enable **Command line interface** and follow the registration prompt.

Target a vault explicitly when needed by placing `vault=<name-or-id>` before the
command:

```bash
obsidian vault="Work" daily
```

**Obsidian Daily Notes plugin defaults:**
- Date format: `YYYY-MM-DD`
- New file location: Vault root
- Template file location: (none)

## Date Handling

Get current date:

```bash
date +%Y-%m-%d
```

Cross-platform relative dates (GNU first, BSD fallback):

| Reference | Command |
|-----------|---------|
| Today | `date +%Y-%m-%d` |
| Yesterday | `date -d yesterday +%Y-%m-%d 2>/dev/null \|\| date -v-1d +%Y-%m-%d` |
| Last Friday | `date -d "last friday" +%Y-%m-%d 2>/dev/null \|\| date -v-1w -v+fri +%Y-%m-%d` |
| 3 days ago | `date -d "3 days ago" +%Y-%m-%d 2>/dev/null \|\| date -v-3d +%Y-%m-%d` |
| Next Monday | `date -d "next monday" +%Y-%m-%d 2>/dev/null \|\| date -v+monday +%Y-%m-%d` |

## Commands

### Open/Create Today's Note

```bash
obsidian daily
```

Opens today's daily note in Obsidian, creating it from template if it doesn't exist.

### Append Entry

```bash
obsidian daily:append content="ENTRY_TEXT"
```

Append without adding a newline:

```bash
obsidian daily:append content="ENTRY_TEXT" inline
```

### Read Note

Today:

```bash
obsidian daily:read
```

Specific date, using the vault's configured daily-note folder and date format:

```bash
obsidian read path="Daily Notes/2025-01-10.md"
```

Relative date (yesterday):

```bash
obsidian read path="Daily Notes/$(date -d yesterday +%Y-%m-%d 2>/dev/null || date -v-1d +%Y-%m-%d).md"
```

### Search Content

```bash
obsidian search query="TERM"
```

### Search Notes

Machine-readable search:

```bash
obsidian search query="TERM" format=json
```

### Specific Vault

Put `vault="NAME"` before the command:

```bash
obsidian vault="Work" read path="Daily Notes/2025-01-10.md"
```

## Example Output

```markdown
- Went to the doctor
- [ ] Buy groceries
- https://github.com/anthropics/skills
- 15:45 This is a log line
```

## Use Cases

**Journal entry:**
```bash
obsidian daily:append content="- Went to the doctor"
```

**Task:**
```bash
obsidian daily:append content="- [ ] Buy groceries"
```

**Link:**
```bash
obsidian daily:append content="- https://github.com/anthropics/skills"
```

**Timestamped log:**
```bash
obsidian daily:append content="- $(date +%H:%M) This is a log line"
```

**Read last Friday:**
```bash
obsidian read path="Daily Notes/$(date -d 'last friday' +%Y-%m-%d 2>/dev/null || date -v-1w -v+fri +%Y-%m-%d).md"
```

**Search for "meeting":**
```bash
obsidian search query="meeting"
```

© github.com/bastos · MIT · bastos/skills

Similar skills

All skills for Notes, tasks and projects →

From the same set2

Project sponsors

Companies that keep this analytics open