← Back to blog

spelunk is now inkentry

The project you know as spelunk is now called inkentry. Same people, same MIT licence, same memory format, same git-notes storage. The name on the tin changed and nothing underneath it did.

If you have spelunk installed, nothing has broken. Your install keeps working and your memory is where you left it. It has simply stopped receiving updates, because 0.9.9 is the last spelunk release and everything after it ships as inkentry.

Bringing your work across

One command:

curl -fsSL https://get.inkentry.com/migrate.sh | sh

That installs inkentry, carries every spelunk memory store over, verifies each one, and only then retires spelunk. Add --dry-run first if you would rather watch it think out loud before it touches anything.

Two things about it are deliberate, because a one-way move deserves them.

It never deletes. Every existing store is opened read-only. If a store fails to migrate, or you decline one, spelunk is left installed and the store is left exactly as it was. The failure mode is "you still have both", not "you have neither".

It verifies what it wrote. Each store is checked against what was read before the migration reports success. A migration that says it worked has compared the two sides rather than assumed them.

If your memory is published to a shared git notes ref, a teammate who has already migrated has carried it there, and a fresh inkentry init in the same repository picks it up.

Why the name changed

Other projects existed that were already too close in name for us to build our own identity with the old one. It also did not tie in to what the product does: spelunk means exploring caves. Sure, diving into legacy code can feel like going underground, but let's face it, the connection was a stretch.

inkentry names the thing the product actually makes: an entry, written in ink. You can strike it through. You cannot erase it. A decision that changes stays on the page with a line through it and the new one underneath, both legible, which is the rule the whole tool is built around.

Where everything lives now

Sourceinkentries/inkentry
Installcurl -fsSL https://get.inkentry.com/install.sh | sh
Docsinkentry.com/docs
This blogyou are on it; the nine posts before this one moved across

The old repository, its releases and its history all stay where they are. Links into them keep working. The spelunk.cloud pages you may have bookmarked redirect here.

What has not changed

v1 is in release candidate. 1.0.0-rc1 is out and the shape it has now is the shape we expect to call 1.0, which is what we said about the shape at 0.9 and still means.

The memory format did not change with the name. Your decisions, requirements and handoffs are the same records in the same git notes, readable by the same commands. Renaming a tool is a poor reason to make anyone rewrite their history, and we did not.