convez.ai
SkillProdutividadeIntermediário
MJ772

Claude Obsidian Archiver

MJ772/Claude-Obsidian-Archiver

Arquiva sessões Claude Code no Obsidian com sincronização automática

Ver no GitHub
InicialPluginScore · de 0 a 100

Automatiza o arquivamento de sessões do Claude Code como arquivos markdown estruturados no Obsidian, com atualizações incrementais e detecção de duplicatas. Executa periodicamente via Task Scheduler, convertendo JSONL para markdown com frontmatter YAML e mantendo índices por projeto.

Instalação

$npx convez-ai MJ772/Claude-Obsidian-Archiver

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Backup e organização de conversas Code em vault Obsidian
  • Criação de histórico pesquisável de projetos de IA
  • Integração de workflows Claude com PKM (Personal Knowledge Management)

Veredito

Ferramenta sólida para quem trabalha com Claude Code e mantém vault Obsidian. Implementação bem pensada em duplicatas e sincronização incremental, mas requer setup manual de Task Scheduler e conhecimento de paths do Windows.

README

A tradução para o português deste README ainda está na fila.

Claude Obsidian Archiver

Automatically archives your Claude Code sessions as full, agent-readable markdown files in your Obsidian vault — with incremental updates and zero duplication.

What it does

Every 3 days, a Windows Task Scheduler task:

  1. Checks if Claude Desktop is running (exits silently if not)
  2. Reads your local Claude Code JSONL session files
  3. Converts them to clean markdown with YAML frontmatter
  4. Appends only new content to existing files (no duplication)
  5. Commits the updated files to your vault's git repo

Quick start

1. Install dependencies

pip install psutil python-dateutil

2. Configure

Copy archiver_config.example.json to your vault root as archiver_config.json and fill in your own paths and project mappings. Add it to .gitignore immediately.

3. Run once to backfill all existing sessions

python session_archiver.py

4. Set up the scheduled task (runs every 3 days automatically)

python setup_task.py

Output format

Each session is saved as YYYY-MM-DD-<session-id>.md with YAML frontmatter:

---
session_id: c3114ffd-750b-4628-96d8-94b566e2e655
project: MyProject
date_started: 2026-05-15
last_updated: 2026-05-22 02:00
message_count: 142
status: active
---

Tool calls are preserved inside collapsible <details> blocks — full fidelity, readable at a glance.

A session index (index.md) is maintained per project folder for fast lookup by agents or search tools.

Project mapping

Edit project_map in archiver_config.json to route sessions from different Claude Code projects to different vault folders:

{
  "project_map": {
    "C--Users-YOUR_NAME-Desktop-YourProject": "wiki/conversations",
    "C--Users-YOUR_NAME-Desktop-OtherProject": "wiki/other/sessions"
  }
}

The project directory name is the folder name inside ~/.claude/projects/ with path separators replaced by --.

Privacy

  • archiver_config.json — add to .gitignore, never commit (contains your paths)
  • session_archive_manifest.json — add to .gitignore, never commit
  • Your session markdown files may contain sensitive conversation content. Review your vault's .gitignore carefully before pushing to any remote.

License

MIT

Ver o original no GitHub

Bom para

Relacionados