К основному содержанию
плагин

session-logger — плагин для Claude Code: журнал сессий

Плагин session-logger для Claude Code записывает ход сессии в Markdown-файл. Хуки фиксируют репозиторий, затронутые файлы и команды Bash.

MIT ★ 586 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add karanb192/claude-code-hooks
/plugin install session-logger@claude-code-hooks
Открыть на GitHub

Что делает session-logger

Плагин создаёт отдельную заметку для каждой сессии: при старте записывает рабочую папку, Git-репозиторий и ветку, а затем добавляет пути файлов и команды Bash. Записи идут через хуки PostToolUse и SessionEnd; параллельные добавления защищены блокировкой файла.

Команды Bash записываются только первой строкой, с обрезкой и попыткой скрыть распространённые секреты. Это не гарантия удаления всех секретов. Содержимое файлов плагин не сохраняет. Заметки по умолчанию попадают в ~/.claude/sessions, а диагностика — в ~/.claude/hooks-logs/; папку заметок можно задать через CC_SESSION_LOG_DIR. При аварийном завершении терминала последняя заметка может остаться без времени окончания.

Какие задачи решает

  • сохранить историю действий в сессии Claude Code
  • найти, какие файлы читались или менялись
  • вспомнить команды Bash, запущенные в сессии
  • зафиксировать итоговый статус Git при завершении

Примеры запросов агенту

  • Начни новую сессию и сохрани журнал действий в Markdown.
  • Прочитай src/app.ts и проверь, чтобы путь файла попал в журнал.
  • Выполни git status --short и заверши сессию с записью итогового статуса.

Как установить session-logger

Через маркетплейс плагинов

/plugin marketplace add karanb192/claude-code-hooks
/plugin install session-logger@claude-code-hooks

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о session-logger

Как установить session-logger в Claude Code?

Выполни команды по порядку: /plugin marketplace add karanb192/claude-code-hooks, затем /plugin install session-logger@claude-code-hooks. После установки перезапусти Claude Code.

Что делает session-logger?

Создаёт Markdown-журнал сессии и дополняет его путями файлов и командами Bash. При завершении добавляет время окончания и итоговый git status --short.

Какие данные сохраняет session-logger?

Он записывает рабочую папку, Git-репозиторий и ветку, пути файлов и первые строки команд Bash. Содержимое файлов не сохраняется; маскирование секретов в командах выполняется с наилучшими усилиями и не гарантирует их полное удаление.

Исходный текст

session-logger · MIT
# session-logger

> Durable markdown log of every Claude Code session: cwd, git repo/branch, files touched, and bash commands run (secret-redacted).

Claude Code sessions are ephemeral: you finish one, switch repos, and two days later can't remember which session touched which file. This hook writes a human-readable, greppable (and Obsidian-friendly) note per session. `SessionStart` seeds the note with YAML frontmatter (session id, cwd, git repo/branch, started timestamp); an async `PostToolUse` hook appends every `Edit`/`Write`/`Read`/`Bash` under "Files Touched" / "Commands Run"; `SessionEnd` fills the `ended:` timestamp and captures the final `git status`. Because async invocations can run concurrently (parallel tool calls), every note write goes through a cross-process file lock so appends can't clobber each other.

## Install

```
/plugin marketplace add karanb192/claude-code-hooks   # once per machine
/plugin install session-logger@claude-code-hooks
```

Restart Claude Code, done. (Or from a shell: `claude plugin install session-logger@claude-code-hooks`.)

## What it does

| Event | Runs | What happens |
|-------|------|--------------|
| SessionStart | sync | Creates the session note (frontmatter + skeleton sections) so PostToolUse has something to append to. On resume, appends a `## Resumed at` marker instead of overwriting. |
| PostToolUse (`Edit\|Write\|Bash\|Read`) | async (zero added latency) | Appends the file path (edited/wrote/read) or the bash command (first line only, truncated, secret-redacted) under the right section, serialized via a file lock. |
| SessionEnd | sync | Fills the frontmatter `ended:` timestamp and appends a `## Session End` section with the final `git status --short`. Idempotent: a duplicate SessionEnd is a no-op. |

It registers against `SessionEnd`, not `Stop`: `Stop` fires at the end of every turn, `SessionEnd` once per session. If the terminal is killed abruptly, the note keeps all activity up to the last tool call, just without a final `ended:` timestamp.

## Configuration

All optional, set via environment variables:

| Variable | Default | Purpose |
|----------|---------|---------|
| `CC_SESSION_LOG_DIR` | `~/.claude/sessions` | Where session notes are written. Point it at an Obsidian vault or iCloud folder for cross-device sync. |
| `CC_SESSION_BASH_TRUNCATE` | `200` | Max characters logged per bash command (first line only, then truncated). Must be a positive integer; anything else falls back to `200`. |

Hook diagnostics (start/append/end/error events) go to `~/.claude/hooks-logs/<YYYY-MM-DD>.jsonl`.

## Data & privacy

Records timestamps, cwd, git repo/branch, file paths, and first-line bash commands. File CONTENTS are never logged, only paths. Bash commands run through a best-effort redactor that masks common inline-secret shapes (sensitive env assignments, `--password`/`--token` flags, Bearer tokens, well-known key prefixes like `ghp_`, `xox`, `sk-`, `AKIA`). Best-effort, NOT a guarantee: treat notes as sensitive and keep synced folders (Obsidian/iCloud) private. The script makes no network calls; everything stays on your machine.

## Uninstall

```
/plugin uninstall session-logger@claude-code-hooks
```

Part of [claude-code-hooks](https://github.com/karanb192/claude-code-hooks): production-ready Claude Code hooks, each installable on its own as a plugin.

© Karan Bansal · MIT · karanb192/claude-code-hooks

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
session-brain Ar9av Скилл session-brain для Claude Code строит интерактивный граф тем по истории сессий без записи в хранилище заметок. Кластеризует диалоги и показывает связи между старыми задачами. CX Codex +1 364установок command-logger davila7 Хук command-logger записывает вызовы инструментов Claude Code с датой и путями к файлам в текстовый лог для отладки и аудита сессий. 952установок perf-investigation-logger composio-community Скилл perf-investigation-logger добавляет структурированные отчёты об исследовании производительности в файлы проекта. Помогает фиксировать прямые цитаты, принятые решения и доказательства замеров. CX Codex +1 2 300установок Clipboard History MCP d-khomenko MCP-сервер Clipboard History MCP сохраняет историю буфера обмена, классифицирует сниппеты и шифрует найденные токены. Даёт ассистенту доступ к ранее скопированным ссылкам, коду и JSON-ответам. CX Codex +1 ★ 19звёзд репо session-search Ar9av Скилл session-search ищет прошлые диалоги с агентом через граф session-brain и загружает стенограмму в текущую беседу. Пригодится, чтобы вспомнить решение давней задачи. CX Codex +1 367установок change-logger davila7 Хук change-logger для Claude Code, который записывает каждую мутацию файлов в CSV-журнал. Срабатывает после операций Edit, MultiEdit, Write и Bash — фиксирует время, инструмент, путь и детали действия. 163установок

Из того же набора28

Весь набор →
provenance Скилл provenance показывает сводку сессии: вызовы инструментов, статус тестов и долю строк кода, написанных агентом. CX Codex +1 ★ 586звёзд репо receipts Скилл receipts для Claude Code показывает карточку личных метрик по сессиям: процент ошибок, объём правок кода и токены на задачу по версиям модели. Отслеживает качество в фоне и помогает заметить, когда оно меняется. CX Codex +1 ★ 586звёзд репо guard-pack Плагин guard-pack для Claude Code запускает семь защитных хуков в одном процессе Node. Первый блокирующий вердикт останавливает цепочку. ★ 586звёзд репо notify-permission Плагин notify-permission пересылает запросы разрешений и ожидания Claude Code в Slack через вебхук, чтобы не сидеть перед терминалом во время долгих задач. ★ 586звёзд репо format-code Плагин format-code для Claude Code форматирует файл сразу после записи или изменения: ruff для Python, prettier для JS, TS, JSON, MD, YAML и HTML. ★ 586звёзд репо auto-stage Плагин auto-stage для Claude Code автоматически добавляет изменённые ассистентом файлы в индекс Git, устраняя ручной вызов git add перед коммитом. ★ 586звёзд репо config-watch Плагин config-watch показывает в сессии любое изменение настроек или скиллов, случившееся посреди работы, либо блокирует его. Для случаев, когда установщик или npm-скрипт правит конфиг во время сессии. ★ 586звёзд репо subagent-spawn-cap Плагин subagent-spawn-cap считает спавны субагентов за сессию: спрашивает разрешение на 20-м, потом каждые 10, а на 60-м отказывает. Возвращает лимит, который Claude убрал в 2.1.224. ★ 586звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой