sync-claude-sessions

Export Claude Code conversations to Obsidian markdown notes with frontmatter metadata.

532|92|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/ArtemXTech/personal-os-skills --skill sync-claude-sessions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-claude-sessions
Source: https://github.com/ArtemXTech/personal-os-skills/tree/main/skills/sync-claude-sessions
Command: npx skills add https://github.com/ArtemXTech/personal-os-skills --skill sync-claude-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Claude Code conversations disappear after sessions end, making it impossible to review past work, track decisions, or build a searchable knowledge base of your AI-assisted work. This Skill syncs sessions into Obsidian as structured markdown notes.

Core Features & Use Cases

  • Automatic Session Sync: Hooks into Claude Code's UserPromptSubmit and Stop events to continuously export session metadata, skills used, and artifacts to Obsidian.
  • Session Annotation: Add titles, tags, status, ratings, and timestamped comments to sessions via natural language or CLI commands, with tag validation against a YAML schema.
  • Resume and Search: List active or past sessions, resume previous conversations interactively, and preserve personal notes across syncs.
  • Use Case: After a long debugging session, say "log session - fixed sync hook, done, debugging, 8" to annotate the session with a validated tag, auto-generated summary, and rating stored in Obsidian frontmatter.

Quick Start

Ask Claude to export today's sessions to Obsidian and list all active sessions so you can pick one to resume.

Frequently Asked Questions about sync-claude-sessions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export Claude Code sessions to Obsidian?

Run the claude-sessions script with the export command, using flags like --today or --all to batch export sessions. Sessions are written to a Claude-Sessions folder as markdown files with frontmatter containing title, summary, skills, and status.

How do I automatically sync Claude Code conversations?

Add UserPromptSubmit and Stop hooks to your Claude Code settings.json that call the sync command on every message. This continuously updates session metadata, skills used, and artifacts without manual exports.

Can I resume a previous Claude Code session?

Yes, use the resume command with --pick for interactive selection, --active for current sessions, or pass a specific session file. The list command shows all sessions with their status to help you find the right one.

Does session sync overwrite my notes in Obsidian?

No, the sync preserves your My Notes section and frontmatter fields including comments, related links, status, tags, and rating. Only machine-generated metadata like summaries and artifacts are refreshed on each sync.

What tags can I use when logging a Claude session?

Valid tags are defined in schema/tags.yaml and include type tags like research, implementation, debugging, and planning, plus project tags like lab, personal, and client. The agent reads this file to validate tags when annotating sessions.