# Obsidian Sync

> Refresh Obsidian dashboard and daily notes from current experiment state

- Skill: `xiangyue-zhang/obsidian-sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xiangyue-zhang/obsidian-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiangyue-zhang/obsidian-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiangyue-zhang (https://skillmd.com/u/xiangyue-zhang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiangyue-zhang/obsidian-sync

---


# obsidian-sync

Refresh progress notes for a Deep Researcher project.

## Usage

```bash
Claude Code: /obsidian-sync --project /path/to/project
Claude Code: /obsidian-sync --project /path/to/project --dashboard-only
Claude Code: /obsidian-sync --project /path/to/project --daily-only
Codex: $obsidian-sync
```

## Behavior

1. Read project config and check `obsidian.enabled`
2. Read `PROJECT_BRIEF.md`, `workspace/MEMORY_LOG.md`, `workspace/state.json`, and `.cycle_counter`
3. Refresh `Dashboard.md` in Obsidian, or `workspace/progress_tracking/Dashboard.txt` if no vault is configured
4. Optionally append a new daily note entry

## Command

```bash
python -m core.obsidian --project /path/to/project
```

If progress export is disabled, tell the user to set `obsidian.enabled: true`. If `obsidian.vault_path` is empty, notes fall back to project-local text files.