# Sync Claude Sessions

> 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.

- Skill: `tomevault-io/sync-claude-sessions` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sync-claude-sessions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sync-claude-sessions/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sync-claude-sessions

---


# Sync Claude Sessions

Export Claude Code conversations to Obsidian for observability and analysis.

## Quick Reference

```bash
# 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](workflows/setup.md) |
| Log/annotate session | [workflows/log-session.md](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.

```yaml
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](https://github.com/ArtemXTech/personal-os-skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-21 -->