๐Ÿ˜

"Consider the elephant. Legend has it its memory is so robust it never forgets."

โ€” Gavin Belson

Claude Code forgets.
Elephant doesn't.

Persistent memory, automated changelogs, and auto-maintained READMEs for Claude Code. Team-shared. Cross-repo.

claude plugin marketplace add tonone-ai/elephant
claude plugin install elephant@elephant

Then restart Claude Code.


Cold start โ†’ memory in one shot

/elephant takeover
 
[!!] 2026-04-11 09:14 : feat: add stripe webhook handler
[!!] 2026-04-10 16:32 : fix: null pointer in auth middleware
2026-04-09 11:05 : refactor user model
2026-04-08 14:22 : update env vars in staging
[!!] 2026-04-07 10:00 : feat: onboarding flow (#142)
โ€ฆ
 
seeded 60 entries (2026-02-01 โ†’ 2026-04-11) โ€” 18 marked [!!]
tip: run /elephant compact to merge old routine entries

Changelog pain? Gone.

/elephant changelog reads your git log since the last tag, categorizes commits by conventional-commit prefix, suggests a semver bump, and writes Keep-a-Changelog sections. Version badge in README? Updated too.

/elephant changelog
 
Current version: 1.6.0
Changes collected: 3 features, 2 fixes, 1 breaking
 
Recommendation: MAJOR โ†’ 2.0.0
Reason: breaking changes detected
 
Choose version:
  [1] 2.0.0  (major) โ€” recommended
  [2] 1.7.0  (minor)
  [3] 1.6.1  (patch)
 
โœ“ CHANGELOG.md updated โ€” v2.0.0 (2026-04-17)
โœ“ README.md version badge: v1.6.0 โ†’ v2.0.0

Commands

/elephant save <text>
Write a memory entry to local + global files. Caveman-compressed to save tokens.
/elephant save !! <text> !!
Write an important entry. Never compressed, never deleted.
/elephant show
Print your full memory file verbatim.
/elephant compact
Merge routine entries older than 7 days into single lines. Keeps token count low.
/elephant takeover [N]
Bootstrap from git history. Seeds the last N commits (default 60). Marks important commits !!
/elephant changelog
Generate or update CHANGELOG.md. Categorizes commits, suggests semver bump, syncs README version badge. Keep-a-Changelog format.
/elephant readme
Generate or update README.md from git history, memory, and project metadata. Preserves your custom sections via <!-- elephant:start --> markers.
/elephant update
Pull latest elephant from GitHub and install. No manual plugin directory navigation.

Why it matters

๐Ÿ”
Stop re-explaining
Every session starts cold. Stack, conventions, ongoing work, past decisions โ€” gone. Elephant loads that context automatically.
๐Ÿ“
Changelogs write themselves
No more release-day archaeology. Semver-aware bump dialog, categorized entries, synced README badge.
๐Ÿ‘ฅ
Team memory
ELEPHANT.md gets committed. Every teammate, every clone, same context โ€” with @author attribution on every entry.
๐ŸŒ
Cross-repo
A global memory at ~/.claude/elephant/memory.md keeps context across every project you work on. Switch repos, keep the thread.
โšก
~150 tokens of history
Caveman compression + compact = a full week of project context in ~150 tokens. vs. 500+ tokens of manual preamble.
๐Ÿš€
Instant cold start
New machine, fresh clone, new teammate. /elephant takeover seeds memory from 60 commits in seconds.

How it works

๐Ÿ“
Just a file
Memory lives in ELEPHANT.md at the repo root. Readable, editable, committable. Share it with your team.
โ˜๏ธ
No cloud
Nothing leaves your machine. No API keys beyond your Claude subscription.
๐Ÿ—œ๏ธ
Token-efficient
Caveman compression strips articles and filler. Compact merges old entries. History stays lean automatically.