Personal-os-skills 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".

install

source · Clone the upstream repo

git clone https://github.com/ArtemXTech/personal-os-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ArtemXTech/personal-os-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/sync-claude-sessions" ~/.claude/skills/artemxtech-personal-os-skills-sync-claude-sessions && rm -rf "$T"

manifest: skills/sync-claude-sessions/SKILL.md

source content

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.