Plaud → Obsidian Skill

Default workflow

1. Check config: plaud-obsidian config --json
2. List recent recordings (use the plaud CLI): plaud files list --json --limit 25
3. Sync selected recordings to Obsidian

Sync invocations

Sync a single recording

plaud-obsidian sync --id <recording-id> --json

Sync multiple specific recordings

plaud-obsidian sync --id <id1>,<id2>,<id3> --json

Sync last N days/weeks

plaud-obsidian sync --last 7d --json
plaud-obsidian sync --last 2w --json

Sync by date range

plaud-obsidian sync --since 2026-03-01 --until 2026-03-31 --json

Sync to GitHub (portable)

plaud-obsidian sync --last 7d --target github --folder "Plaud Recordings" --json

Requires GITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPO env vars (and optionally GITHUB_BRANCH).

Override vault path and folder (local only)

plaud-obsidian sync --last 7d --vault "C:\Obsidian\Work" --folder "Meetings" --json

Choose note types

# Transcript only
plaud-obsidian sync --id <id> --types transcript --json

# AI summaries only
plaud-obsidian sync --id <id> --types ai-summaries --json

# Both (default)
plaud-obsidian sync --id <id> --types transcript,ai-summaries --json

Force overwrite existing notes

plaud-obsidian sync --id <id> --force --json

Output (JSON envelope)

Success:

{
  "ok": true,
  "data": {
    "syncDate": "2026-04-08T12:00:00.000Z",
    "recordingsFetched": 3,
    "recordingsProcessed": 3,
    "notesWritten": 6,
    "notesSkipped": 0,
    "notesFailed": 0,
    "results": [...]
  }
}

Failure:

{
  "ok": false,
  "error": { "code": "AUTH_MISSING", "message": "...", "retryable": false }
}

Note file structure

Each recording produces one or more .md files in the vault folder:

• YYYY-MM-DD-Recording-Title_transcript.md — timestamped speaker-labelled transcript
• YYYY-MM-DD-Recording-Title_ai-content.md — AI summary (and additional AI fields if available)

Each note has YAML frontmatter:

---