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 Notes section- Frontmatter:
comments, related, status, tags, rating
Frontmatter Schema
See Templates/Types/claude-session.md for 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.
Source: ArtemXTech/personal-os-skills — distributed by TomeVault.
1---2name: sync-claude-sessions3description: Sync Claude Code sessions to Obsidian markdown. Export, resume, add notes, close sessions. USE WHEN user says "sync sessions", "export sessions", "resume session", "add session note", "close session", "log session". Use when this capability is needed.4---56# Sync Claude Sessions78Export Claude Code conversations to Obsidian for observability and analysis.910## Quick Reference1112```bash13# Alias (add to ~/.zshrc)14alias cs="python3 ~/.claude/skills/sync-claude-sessions/scripts/claude-sessions"1516# Common commands17cs list # Active sessions18cs list --all # All sessions19cs export --today # Export today's sessions20cs resume --pick # Interactive resume21cs note "got it working" # Add timestamped comment22cs close "done" # Mark session done23```2425## Commands2627| Command | Description |28|---------|-------------|29| `sync` | Sync session (hook or explicit) |30| `export` | Batch export (`--today`, `--all`, `<file>`) |31| `resume` | Resume session (`--pick`, `--active`, `<file>`) |32| `note` | Add timestamped comment |33| `close` | Mark done + optional comment |34| `list` | List sessions (`--active`, `--all`, `--json`) |3536## Workflow Routing3738| Task | Workflow |39|------|----------|40| Enable live sync hooks | [workflows/setup.md](workflows/setup.md) |41| Log/annotate session | [workflows/log-session.md](workflows/log-session.md) |4243## Output4445Sessions exported to `Claude-Sessions/` with:46- Frontmatter: `type`, `date`, `session_id`, `title`, `summary`, `skills`, `messages`, `status`, `tags`, `rating`, `comments`47- Content: Summary, Skills Used (linked), Artifacts (wiki-linked), My Notes, Conversation4849## Preserved on Sync5051- `## My Notes` section52- Frontmatter: `comments`, `related`, `status`, `tags`, `rating`5354## Frontmatter Schema5556> See `Templates/Types/claude-session.md` for the canonical template.5758```yaml59type: claude-session60date: YYYY-MM-DD61session_id: uuid62title: "..."63summary: "..." # auto-generated by Claude Code or haiku64skills: [skill1, skill2]65messages: 4266last_activity: ISO timestamp67status: active | done | blocked | handoff68tags: [] # see schema/tags.yaml69rating: null # 1-1070comments: |71 [2026-02-05 14:30] Comment here72 [2026-02-05 15:00] Another comment73related: []74```7576## Tags Schema7778Tags are defined in `schema/tags.yaml` with descriptions, keywords, and examples.7980**Type tags:** research, implementation, debugging, planning, brainstorm, admin, quick, video, automation, writing8182**Project tags:** lab, openclaw, personal, client8384Agent should read `schema/tags.yaml` to validate tags when logging sessions.8586---87> Source: [ArtemXTech/personal-os-skills](https://github.com/ArtemXTech/personal-os-skills) — distributed by [TomeVault](https://tomevault.io).88<!-- tomevault:4.0:skill_md:2026-06-21 -->
tomevault-io