Sync Claude Sessions
Export Claude Code conversations to Obsidian for observability and analysis.
Quick Reference
# Alias (add to ~/.zshrc)
alias cs="python3 ~/.claude/skills/sync-claude-sessions/scripts/claude-sessions"
# Common commands
cs list # Active sessions
cs list --all # All sessions
cs export --today # Export today's sessions
cs resume --pick # Interactive resume
cs note "got it working" # Add timestamped comment
cs close "done" # Mark session done
Commands
| Command | Description |
|---|---|
sync | Sync session (hook or explicit) |
export | Batch export (--today, --all, <file>) |
resume | Resume session (--pick, --active, <file>) |
note | Add timestamped comment |
close | Mark done + optional comment |
list | List sessions (--active, --all, --json) |
Workflow Routing
| Task | Workflow |
|---|---|
| Enable live sync hooks | workflows/setup.md |
| Log/annotate session | workflows/log-session.md |
Output
Sessions exported to Claude-Sessions/ with:
- Frontmatter:
type,date,session_id,title,summary,skills,messages,status,tags,rating,comments - Content: Summary, Skills Used (linked), Artifacts (wiki-linked), My Notes, Conversation
Preserved on Sync
## My Notessection- Frontmatter:
comments,related,status,tags,rating
Frontmatter Schema
See
Templates/Types/claude-session.mdfor the canonical template.
type: claude-session
date: YYYY-MM-DD
session_id: uuid
title: "..."
summary: "..." # auto-generated by Claude Code or haiku
skills: [skill1, skill2]
messages: 42
last_activity: ISO timestamp
status: active | done | blocked | handoff
tags: [] # see schema/tags.yaml
rating: null # 1-10
comments: |
[2026-02-05 14:30] Comment here
[2026-02-05 15:00] Another comment
related: []
Tags Schema
Tags are defined in schema/tags.yaml with descriptions, keywords, and examples.
Type tags: research, implementation, debugging, planning, brainstorm, admin, quick, video, automation, writing
Project tags: lab, openclaw, personal, client
Agent should read schema/tags.yaml to validate tags when logging sessions.