citoc

Changes In The Old Commit

Generate a markdown snapshot of everything that has changed since your last git commit — staged, unstaged, and untracked files — with full diff details.

Install

npm install -g @rdiscoding/citoc

Usage

Navigate to any git repository and run:

citoc

That's it. A file like citoc-logs/CHANGES_2026-03-03_14-22-10.md will be created in your project root.

Output

The generated markdown includes:

• Repo name, branch, timestamp, and last commit info
• Unstaged changes — files modified but not yet staged
• Staged changes — files staged and ready to commit
• Untracked files — new files not yet tracked by git
• Diff details for each changed file — line counts (+added / -removed) and the full diff block

Edge Cases Handled

| Situation | Behavior | |---|---| | Not a git repo | Exits with a clear error, no file created | | No commits yet | Creates file listing all untracked files with a note | | Nothing changed | Creates file noting the working tree is clean | | Detached HEAD | Notes it and continues normally | | Binary files | Notes that no diff is available |

Tip

Add citoc-logs/ to your .gitignore to keep generated files out of version control:

echo "citoc-logs/" >> .gitignore

License

MIT