whatisgithub

What is vibediary?

reezanahamed/vibediary — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code tool that turns your coding session transcripts into a plain English diary, living docs, and a visual project map.

Mindmap

mindmap
  root((repo))
    What it does
      Reads session transcripts
      Writes plain English diary
      Generates visual map
    Tech stack
      Python
      Claude Code hooks
    Use cases
      Document why code changed
      Understand old projects
      Auto update docs on session end
    Audience
      Vibe coders
      Beginners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a plain English diary explaining what got built and why across your Claude Code sessions.

USE CASE 2

Keep a living explanation of how your whole project works, updated automatically after each session.

USE CASE 3

View a hoverable visual map of your project to quickly understand what each part does.

USE CASE 4

Automatically refresh your project docs every time a Claude Code session ends.

What is it built with?

PythonClaude Code

How does it compare?

reezanahamed/vibediary0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencevibe codergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Only works with Claude Code sessions, and each run spends tokens from your Claude plan.

MIT license: use it, modify it, and share it freely, including commercially.

So what is it?

Vibediary turns your Claude Code coding sessions into a plain English project diary, using one command and no separate API keys. The idea behind it is that after months of AI assisted coding, a developer can end up with working code they no longer understand, since the AI wrote much of it. The code shows what was built, but the reasoning behind decisions, what was asked for, what broke, and why things turned out a certain way, usually disappears the moment a terminal is closed. Vibediary reads through your Claude Code session transcripts and writes that missing story down in beginner friendly language. To use it, you clone the repository into your Claude Code skills folder, then run a single slash command inside any project. This produces three files in a docs folder: a dated diary of what got built and why, a living explanation of how the whole project works that stays current on each run, and a visual, hoverable map of the project where each part shows a simple explanation of what it does. Two safety measures are built in. The generated folder starts out excluded from version control by default, so the diary will not accidentally get committed until you choose to include it, and if a project already has its own docs folder for something else, vibediary writes into a separate subfolder instead of touching existing files. There is also an optional automatic mode that runs the diary update whenever a Claude Code session ends, set up through a short snippet in the project's settings file. Each automatic run is a real Claude session and uses tokens from your plan, so the author suggests running the command by hand if you close sessions frequently. The tool only works with Claude Code sessions, cannot see changes made outside those sessions, and since it repeats what you typed, private information mentioned in a session could end up in the generated diary. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install reezanahamed/vibediary into my Claude Code skills folder and run it on my project.
Prompt 2
Set up the optional SessionEnd hook so vibediary updates my docs automatically after each session.
Prompt 3
Explain what vibediary writes to docs/diary.md versus docs/how-it-works.md.
Prompt 4
Help me review the vibediary docs folder for private information before I remove its gitignore.

Frequently asked questions

What is vibediary?

A Claude Code tool that turns your coding session transcripts into a plain English diary, living docs, and a visual project map.

What language is vibediary written in?

Mainly Python. The stack also includes Python, Claude Code.

What license does vibediary use?

MIT license: use it, modify it, and share it freely, including commercially.

How hard is vibediary to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is vibediary for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.