OpenParable
Skip to content
← Back to skills

Sync Claude Sessions

Apps & Automation
sync-claude-sessions

Sync Claude Sessions is an Agent Skill for apps & automation published in the ArtemXTech/personal-os-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/ArtemXTech/personal-os-skills/blob/HEAD/skills/sync-claude-sessions/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/sync-claude-sessions, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

CommandDescription
syncSync session (hook or explicit)
exportBatch export (--today, --all, <file>)
resumeResume session (--pick, --active, <file>)
noteAdd timestamped comment
closeMark done + optional comment
listList sessions (--active, --all, --json)

Workflow Routing

TaskWorkflow
Enable live sync hooksworkflows/setup.md
Log/annotate sessionworkflows/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.