session-logger — плагин для Claude Code: журнал сессий
Плагин session-logger для Claude Code записывает ход сессии в Markdown-файл. Хуки фиксируют репозиторий, затронутые файлы и команды Bash.
MIT ★ 586 обновлён 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install session-logger@claude-code-hooksЧто делает 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