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

- **Type:** Skill
- **Install:** `agentstack add skill-artemxtech-personal-os-skills-sync-claude-sessions`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ArtemXTech](https://agentstack.voostack.com/s/artemxtech)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ArtemXTech](https://github.com/ArtemXTech)
- **Source:** https://github.com/ArtemXTech/personal-os-skills/tree/main/skills/sync-claude-sessions
- **Website:** https://lab.artemzhutov.com/

## Install

```sh
agentstack add skill-artemxtech-personal-os-skills-sync-claude-sessions
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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`, ``) |
| `resume` | Resume session (`--pick`, `--active`, ``) |
| `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 & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ArtemXTech](https://github.com/ArtemXTech)
- **Source:** [ArtemXTech/personal-os-skills](https://github.com/ArtemXTech/personal-os-skills)
- **License:** MIT
- **Homepage:** https://lab.artemzhutov.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-artemxtech-personal-os-skills-sync-claude-sessions
- Seller: https://agentstack.voostack.com/s/artemxtech
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.