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
npx skills add bastos/skills --skill obsidian-daily -a claude-codeWhat 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 groceriesto 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-code2Manually: put the files in place
~/.claude/skills/obsidian-daily/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/obsidian-daily/
1Skills CLI (Vercel)
npx skills add bastos/skills --skill obsidian-daily -a codex2Manually: put the files in place
.agents/skills/obsidian-daily/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bastos/skills --skill obsidian-daily -a cursor2Manually: put the files in place
.cursor/skills/obsidian-daily/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bastos/skills obsidian-daily2Manually: put the files in place
.github/skills/obsidian-daily/SKILL.md1Skills CLI (Vercel)
npx skills add bastos/skills --skill obsidian-daily -a gemini-cli2Platform CLI
gemini skills install https://github.com/bastos/skills --path obsidian-dailyManually: put the files in place
.devin/skills/obsidian-daily/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bastos/skills --skill obsidian-daily -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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