Skip to content
Skills Library
AI & agents · Automation

sessionwiki-sync

/sessionwiki-sync

Sync Claude Code session transcripts into the user's sessionwiki and ingest them into the wiki. Use when the user says "sync the wiki", "update sessionwiki", "ingest recent sessions", "refresh the knowledge base", or asks a knowledge question that would benefit from up-to-date sessions. Also use when the user explicitly asks to refresh or rebuild the LLM wiki from their agent history.

Repository
sessionwiki ↗
Licence
MIT
Last repository change
13.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Sync Claude Code session transcripts into the user's sessionwiki and ingest them into the wiki. Use when the user says "sync the wiki", "update sessionwiki", "ingest recent sessions", "refresh the knowledge base", or asks a knowledge question that would benefit from up-to-date sessions. Also use when the user explicitly asks to refresh or rebuild the LLM wiki from their agent history.

Triggers from the description

sync the wikiupdate sessionwikiingest recent sessionsrefresh the knowledge base
Original author description

Sync Claude Code session transcripts into the user's sessionwiki and ingest them into the wiki. Use when the user says "sync the wiki", "update sessionwiki", "ingest recent sessions", "refresh the knowledge base", or asks a knowledge question that would benefit from up-to-date sessions. Also use when the user explicitly asks to refresh or rebuild the LLM wiki from their agent history.

How it works

  1. What this skill does
  2. When to use
  3. Workflow
  4. Options
  5. Hook installation (optional, for auto-sync)
  6. Troubleshooting
Original SKILL.md headings · 107 lines, 568 words
SKILL.md preview
---
name: sessionwiki-sync
description: Sync Claude Code session transcripts into the user's sessionwiki and ingest them into the wiki. Use when the user says "sync the wiki", "update sessionwiki", "ingest recent sessions", "refresh the knowledge base", or asks a knowledge question that would benefit from up-to-date sessions. Also use when the user explicitly asks to refresh or rebuild the LLM wiki from their agent history.
---

# sessionwiki-sync

## What this skill does

The user maintains a Karpathy-style LLM Wiki — a local, file-based knowledge base compiled from their Claude Code (and Codex CLI) session transcripts.

This skill runs the full sync pipeline:

```
~/.claude/projects/*/*.jsonl         (raw session transcripts)
        │
        ▼   python3 -m sessionwiki sync
sessionwiki/raw/sessions/<proj>/*.md     (Karpathy layer 1 — immutable markdown)
        │
        ▼   /wiki-ingest              (Claude in the loop)
sessionwiki/wiki/sources, entities,      (Karpathy layer 2 — LLM-maintained wiki)
              concepts, syntheses
        │
        ▼   python3 -m sessionwiki build
sessionwiki/site/                         (Karpathy layer 3 — static HTML)
```

## When to use

Invoke this skill when the user:

- Says "sync the wiki", "update sessionwiki", "ingest recent sessions", "refresh the knowledge base"
- Asks a knowledge question that would benefit from the latest sessions ("what have I been working on this week?") — run sync first, then `/wiki-query`
- Starts a new project and wants context from past work
- Says "what's new" or "catch me up" in a context where session history matters

Do NOT invoke when:

- The user is asking a question unrelated to their own work
- The tool is not installed (check for `sessionwiki/` directory first)

## Workflow

1. **Locate the sessionwiki install.** Check the current working directory and common locations:
   - `./` (if cwd contains `sessionwiki/` package)
   - `~/Desktop/2026/production-draft/sessionwiki/`
   - `~/sessionwiki/`
   - `$SESSIONWIKI_HOME` (or legacy `$LLMWIKI_HOME`) environment variable

   If you can't find it, tell the user and stop.

2. **Run the converter** (idempotent — safe to re-run):
   ```bash
   cd <sessionwiki-dir>
   python3 -m sessionwiki sync
   ```
   Capture the summary line: `N converted, M unchanged, K live, J filtered, X errors`.

3. **If N == 0**, report that the wiki is up to date and stop.

4. **If N > 0**, ingest the new files into the wiki using the Ingest Workflow from the repo's `CLAUDE.md`. Process one project at a time. If more than 20 new files, ask the user whether to process all or a subset first.

5. **Append to `wiki/log.md`**:
   ```
   ## [YYYY-MM-DD] sync | <N> sessions across <M> projects
   ```

6. **Report** what was converted, which wiki pages were created or updated, and any contradictions flagged.

## Options

The converter supports flags the user may want:

```bash
python3 -m sessionwiki sync --project <substring>       # only one project
python3 -m sessionwiki sync --since 2026-04-01          # only recent
python3 -m sessionwiki sync --include-current           # include <60min live
python3 -m sessionwiki sync --force                     # ignore state, reconvert all
python3 -m sessionwiki sync --dry-run                   # preview without writing
```

## Hook installation (optional, for auto-sync)

If the user wants the converter to run automatically on every Claude Code session start, offer to add this to `~/.claude/settings.json`:

```json
{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "(python3 /absolute/path/to/sessionwiki/tools/sessions_to_markdown.py > /tmp/sessionwiki-sync.log 2>&1 &) ; exit 0"
          }
        ]
      }
    ]
  }
}
```

The `( ... &) ; exit 0` pattern ensures the hook runs in the background and never blocks session start.

## Troubleshooting

- **Permission errors on `raw/`**: the converter writes to `sessionwiki/raw/sessions/`. Make sure the repo is writable.
- **Nothing converted, only "live"**: the default 60-minute live filter is skipping recent sessions. Pass `--include-current` to override, or wait an hour.
- **Converter says "module 'tomllib' not found"**: stale source. Update to the current version (`tools/sessions_to_markdown.py` uses `json`, not `tomllib`).
- **Privacy**: the converter redacts username, API keys, tokens, and emails by default. If you see unredacted PII, check `examples/sessions_config.json` → `redaction.real_username`.

Versions

The database has no other skills named sessionwiki-sync.

Database snapshot: 13.11.2026 · package version 871fd0daf91e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100llmwiki-sync
    Sync Claude Code session transcripts into the user's llmwiki and ingest them into the wiki. Use when the user says "sync the wiki", "update llmwiki", "ingest recent sessions", "refresh the knowledge base", or asks a knowledge question that would benefit from up-to-date sessions.…
  • 90sessionwiki-ingest
    Ingest one source document (or a folder of them) into the sessionwiki. Use when the user drops a new markdown file, PDF, or URL into the wiki and asks you to process it. The user will typically say "ingest this", "add this to the wiki", "process this file into the wiki", or…
  • 100sessionwiki-query
    Answer a question by querying the user's sessionwiki. Use when the user asks about their own past work — "what did I decide about X", "what have I been working on", "how did I solve Y", "what's my preferred approach to Z", or any question that the wiki (built from their session…
  • 86wiki-ingest
    把 agent 会话里的知识摄入 Meiqiu 知识库(个人 LLM Wiki)。当用户要求把会话摄入知识库、提炼知识到 wiki 时使用。
  • 100bootstrap
    Bootstrap an LLM-maintained wiki for the current project. Use when a user asks to create, initialize, or refresh a project wiki, LLM wiki, QMD wiki, or codebase knowledge base for Claude Code, Codex, or Pi.
  • 100wiki-ingest
    Compile articles, documents, or notes into a structured wiki knowledge base. Use when user says 'ingest to wiki', 'compile to knowledge base', 'update wiki', 'wiki ingest', 'add this to wiki', or invokes /wiki-ingest. Supports single or batch ingest. Triggers: wiki, ingest,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.