claude-history-ingest
Ingest Claude Code conversation/session history into Obsidian as distilled knowledge. Use for importing or mining past Claude sessions, .claude data, project/session history, or audit logs.
Install / Use
npx skills add Ar9av/obsidian-wiki --skill claude-history-ingestInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of claude-history-ingest
claude-history-ingest scores 95/100 on our quality scale, 372nd of 4,700 Development & Engineering skills we index (top 8%).
Its SKILL.md is 22 KB long, well organised into 38 sections with 19 code examples: a thorough specification that gives an agent plenty to work with.
With 3,485 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so claude-history-ingest is actively maintained.
- Our last check on 2026-11-16 could not reach the source (HTTP 404); it may have been moved or deleted.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit ā read the skill file before letting an agent act on it.
claude-history-ingest compared with similar skills
All 4 of these similar skills score higher than claude-history-ingest; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| claude-history-ingest (this skill)by Ar9av | 95 | 3.5k | 54d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install claude-history-ingest?
- Run
npx skills add Ar9av/obsidian-wiki --skill claude-history-ingest. The install tabs above show the steps for each supported agent. - Which AI agents does claude-history-ingest work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is claude-history-ingest safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is claude-history-ingest still maintained?
- The repository was last updated about 2 months ago, so claude-history-ingest is actively maintained.
Skill content
View source on GitHubname: claude-history-ingest description: > Ingest Claude Code conversation/session history into Obsidian as distilled knowledge. Use for importing or mining past Claude sessions, .claude data, project/session history, or audit logs.
Claude History Ingest ā Conversation Mining
You are extracting knowledge from the user's past Claude Code conversations and distilling it into the Obsidian wiki. Conversations are rich but messy ā your job is to find the signal and compile it.
This skill can be invoked directly or via the wiki-history-ingest router (/wiki-history-ingest claude).
Before You Start
Writing profile: Before drafting or rewriting natural-language Markdown, read and apply the Writing Profile Resolution section in llm-wiki/SKILL.md. Framework schema, provenance, safety, and operation-specific requirements take precedence.
WRITING.md preferences apply only to newly drafted or rewritten natural-language Markdown; preserve source content and structured records.
- Resolve config ā follow the Config Resolution Protocol in
llm-wiki/SKILL.md(inline@nameoverride ā walk up CWD for.envā global config ā prompt setup). This givesOBSIDIAN_VAULT_PATHandCLAUDE_HISTORY_PATH(defaults to~/.claude) - Read
.manifest.jsonat the vault root to check what's already been ingested - Read
index.mdat the vault root to know what the wiki already contains - Project Scoping ā read
WIKI_SKIP_PROJECTSfrom config (comma-separated substrings). Exclude any project directory whose name contains one of them from every step below (scan, delta, sampling, manifest writes). If the user names extra projects to skip this run, add them. Apply the exclusion once, uniformly ā don't hand-writegrep -vfilters into individual commands, which drifts between the scan and manifest steps.
Ingest Modes
Append Mode (default)
Check .manifest.json for each source file (conversation JSONL, memory file). Only process:
- Files not in the manifest (new conversations, new memory files, new projects)
- Files whose modification time is newer than their
ingested_atin the manifest
This is usually what you want ā the user ran a few new sessions and wants to capture the delta.
Portable keys when comparing. Manifest keys follow the source key contract (v2) in
llm-wiki/SKILL.mdā.manifest.json. A session under$HOMEis keyed~-relative (~/.claude/projects/.../abc.jsonl), never by the expanded machine path; vault-relative and pseudo-keys are the other two forms. Before deciding a file is "new", resolve the stored key the same way the tool does (expand~/env vars, resolve vault-relative against the vault root) ā otherwise an already-tracked file looks new and gets re-ingested. Thescripts/manifest.pyhelper does this for you:# New/modified sources, honoring WIKI_SKIP_PROJECTS + --skip: python3 "$OBSIDIAN_WIKI_REPO/scripts/manifest.py" delta "$OBSIDIAN_VAULT_PATH" \ --scan "$CLAUDE_HISTORY_PATH/projects/*/memory/*.md" # One-time repair if the manifest still holds legacy absolute keys: python3 "$OBSIDIAN_WIKI_REPO/scripts/manifest.py" migrate "$OBSIDIAN_VAULT_PATH" --dry-runThe helper is optional ā if it's unavailable, apply the same resolution inline before every manifest lookup and write.
Pre-extraction (recommended ā run before ingest)
Raw JSONL files are 80-90% noise: tool_use blocks, thinking blocks, progress events, and
file-history-snapshot entries dominate by byte count. The scripts/extract-jsonl.py helper
strips all of that and writes compact signal-only JSON to ~/.claude/extracted/, achieving
50ā200Ć file-size reduction (e.g. 12 MB JSONL ā 64 KB extracted). This lets the skill read
5ā10Ć more conversations per run within the same token budget.
Run it as a pre-step before invoking this skill:
# First run ā extract everything (skip excluded projects)
python3 "$OBSIDIAN_WIKI_REPO/scripts/extract-jsonl.py" --skip tsg,autom8
# Incremental ā only sessions modified in the last day
python3 "$OBSIDIAN_WIKI_REPO/scripts/extract-jsonl.py" \
--since "$(date -v-1d +%Y-%m-%d)" --skip tsg,autom8
Extracted files live at ~/.claude/extracted/<project-dir>/<session-id>.json and contain:
{
"session_id": "uuid",
"project": "-Users-name-myapp",
"cwd": "/Users/name/myapp",
"start_ts": "...",
"end_ts": "...",
"n_turns": 18,
"n_user_words": 620,
"turns": [
{"role": "user", "text": "..."},
{"role": "assistant", "text": "..."}
]
}
When Step 3 reads conversations, always prefer the extracted file over the raw JSONL. (See Step 3.)
If extract-jsonl.py was not run first, fall back to raw JSONL ā but note the coverage will be
shallower because each raw file costs far more tokens to read.
Conversation Sampling Heuristic
A history path can hold hundreds of conversation JSONLs ā do not try to read them all. Per project:
- If the project already has memory files (
memory/*.md), ingest those first (they are pre-distilled signal), then also process conversations not yet in the manifest ā new conversations should still be captured even for memory-rich projects. - If the project has no memory files, read only the 3 most recent conversations (by mtime) to characterize it. Prefer pre-extracted files (see above) ā they are cheap enough that you can read 5ā10 in the same token budget as 1 raw JSONL.
- Always report what you sampled vs skipped (e.g. "agenttower: 7 memory files + 4 new conversations ingested, 14 unchanged conversations skipped"), so the coverage gap is visible rather than silent.
Full Mode
Process everything regardless of manifest. Use after a wiki-rebuild or if the user explicitly asks.
Claude Code Data Layout
Claude Code stores data in two locations. Scan both.
Source 1: ~/.claude/ (CLI sessions)
~/.claude/
āāā projects/ # Per-project directories
ā āāā -Users-name-project-a/ # Path-derived name (slashes ā dashes)
ā ā āāā <session-uuid>.jsonl # Conversation data (JSONL)
ā ā āāā memory/ # Structured memories
ā ā āāā MEMORY.md # Memory index
ā ā āāā user_*.md # User profile memories
ā ā āāā feedback_*.md # Workflow feedback memories
ā ā āāā project_*.md # Project context memories
ā āāā -Users-name-project-b/
ā ā āāā ...
āāā sessions/ # Session metadata (JSON)
ā āāā <pid>.json # {pid, sessionId, cwd, startedAt, kind, entrypoint}
āāā history.jsonl # Global session history
āāā tasks/ # Subagent task data
āāā plans/ # Saved plans
āāā settings.json
Source 2: ~/Library/Application Support/Claude/local-agent-mode-sessions/ (Desktop app agent sessions)
Pre-check first. Many users are CLI-only and have no desktop sessions. Before walking the structure below, confirm it's non-empty:
DESKTOP_SESSIONS="$HOME/Library/Application Support/Claude/local-agent-mode-sessions" [ -d "$DESKTOP_SESSIONS" ] && find "$DESKTOP_SESSIONS" -name "audit.jsonl" | head -1If that prints nothing, skip this entire section (Source 2 + Step 3b) and don't narrate it.
The Claude desktop app stores local agent mode sessions here. The structure is deeply nested:
~/Library/Application Support/Claude/local-agent-mode-sessions/
āāā <outer-uuid>/
āāā <inner-uuid>/
āāā local_<session-uuid>.json # Session metadata
āāā local_<session-uuid>/
āāā audit.jsonl # Audit log ā tool calls, file reads, commands run
āāā .claude/
āāā projects/
āāā <path-encoded-name>/ # Same path-encoding as ~/.claude/projects/
āāā <uuid>.jsonl # Conversation transcript (same JSONL format as CLI)
How to find all local-agent-mode sessions:
# Find all session metadata files
find ~/Library/Application\ Support/Claude/local-agent-mode-sessions -name "local_*.json" -maxdepth 4
# Find all audit logs
find ~/Library/Application\ Support/Claude/local-agent-mode-sessions -name "audit.jsonl"
# Find all conversation transcripts
find ~/Library/Application\ Support/Claude/local-agent-mode-sessions -name "*.jsonl" -path "*/.claude/projects/*"
Session metadata (local_<uuid>.json) ā JSON file with fields like sessionId, cwd, startedAt, model, title. Read this first to understand the session context before opening the transcript.
Audit log (audit.jsonl) ā Each line is a JSON record of one agent action: tool calls (Read, Write, Bash, Edit), file accesses, shell commands executed, MCP calls. Useful for understanding what the agent actually did ā often richer signal than the conversation text alone. Fields: type, toolName, input, output, timestamp, sessionId.
Conversation transcript (.claude/projects/.../<uuid>.jsonl) ā Identical format to CLI conversation JSONL. Parse the same way as ~/.claude/projects/*/*.jsonl.
Key data sources ranked by value (both locations combined):
- Memory files (
~/.claude/projects/*/memory/*.md) ā Pre-distilled, already wiki-friendly. Gold. - Conversation JSONL (both
~/.claude/projects/*/*.jsonland desktop app transcripts) ā Full conversation transcripts. Rich but noisy. - Audit logs (
audit.jsonlin desktop sessions) ā Tool-call level record of what was done. Useful for extracting concrete actions, file patterns, and command patterns even when the conversation is sparse. - Session metadata (
sessions/*.jsonandlocal_*.json) ā Tells you which project, when, and what CWD.
Step 1: Survey and Compute Delta
Scan both data locations and compare against .manifest.json:
# --- Source 1: CLI sessions (~/.claude) ---
# Find all projects
Glob: ~/.claude/projects/*/
# Find memory files (highest value)
Glob: ~/.claude/projects/*/memory/*.md
# Find conversation JSONL files
Glob: ~/.claude/projects/*/*.jsonl
# --- Source 2: Desktop app local-agent-mode sessions ---
DESKTOP_SESSIONS="$HOME/Library/Application Support/Claude/local-agent-mode-sessions"
# Session metadata
find "$DESKTOP_SESSIONS" -name "local_*.json" -maxdepth 4
# Audit logs
find "$DESKTOP_SESSIONS" -name "audit.jsonl"
# Conversation transcripts
find "$DESKTOP_SESSIONS" -name "*.jsonl" -path "*/.claude/projects/*"
Build a unified inventory and classify each file:
- New ā not in manifest ā needs ingesting
- Modified ā in manifest but file is newer ā needs re-ingesting
- Unchanged ā in manifest and not modified ā skip in append mode
Report to the user: "Found X CLI projects, Y desktop sessions. Memory files: A. Conversations: B. Audit logs: C. Delta: D new, E modified."
Step 2: Ingest Memory Files First
Memory files are already structured with YAML frontmatter:
---
name: memory-name
description: one-line description
type: user|feedback|project|reference
---
Memory content here.
For each memory file:
- Read it and parse the frontmatter
usertype ā feeds into an entity page about the user, or concept pages about their domainfeedbacktype ā feeds into skills pages (workflow patterns, what works, what doesn't)projecttype ā feeds into entity pages for the projectreferencetype ā feeds into reference pages pointing to external resources
The MEMORY.md index file in each project is a quick summary ā read it first to decide which individual memory files are worth reading in full.
Step 3: Parse Conversation JSONL
Always check for a pre-extracted file first (see Pre-extraction section above). For each
conversation ~/.claude/projects/<proj>/<uuid>.jsonl, look for its counterpart at
`~/.claude/extracted/<proj>/<uuid>.j
Truncated for display ā read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code ā from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k𤯠LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
