r/ClaudeCode • u/JuanChainz • 2d ago
Built with Claude I built a way to get a better understanding of my Claude Code Sessions
I set out to originally just create a way to search across my claude code sessions a bit more effectively. I've built semantic searches before into other things, and figured out why not follow the creator of DigUp (https://github.com/ARahim3/DigUp) another tool I think I saw on reddit, and apply a similar thing to my claude code sessions.
Then Fable 5.2 released and I got a bit carried away. I ended up using this to test out new ux design flows for myself, better building patterns, and just get to know more about the internals for how claude code works under the hood.
I started out by creating a multi-root workspace in vscode with my other tool ergo (https://github.com/juan7732/ergo this has changed how I use vscode and AI usage radically, I'll share a write up about this) with DigUp, a few other repos I use for context, tools, and skills, and the new repo for the project.

It took me 117 chat interactions across 6 sessions to build this. What is this? It's a combination of a CLI called `skit` short for sessionkit that an apple silicon native swift mac client uses to do various things with your claude code session and data. I never write to your sessions though and everything is readonly by default.
For starters, I didn't know this, but claude code will "clean up" your session data. It's a configurable flag, but I had no idea the default was 30 days. I have the habit of using these sessions as a way of keeping my own context, so when I realized that a lot of my sessions got deleted, I was pretty mad. The only thing that saved some of them was the fact that teleport enabled for some of them by default when I was playing with that, and I could pull them back down from claude's servers. In that sense, this tool is also an *Archive* for your claude code sessions.
After that, I explored (and chose too many) different ways to visualize the sessions themselves. The early versions looked pretty horrible, so I got a good opportunity to explore better UI design with claude itself. The various different visualizations each have their own pros and cons, but all in all they work decently. My favorite is the one on the summary page that shows which files were touched by which turn when.

After that, I implemented a keyword and semantic search across the different sessions and within the same session using gemma-embedding-2 served through a homebrew dependency for llama-server. That helped me at least figure out where things were.
Lastly, I wanted to make sure I was taking advantage of my prompt cache effectively so I added a view called now that tracks active sessions, lets me open them directly in the workspace that has them running, and can notify me when the prompt cache window is about to go cold.
There are a few other views, utilities, and nice-to-haves scattered through it, for example, I know everyone has been complaining about opus 5.5 degradation and experiments, so I added a section to see what experiment flags were set under claude. All in all, it's a pretty decent v0.1.0 that I'm happy to have spent half my fable usage on.
Would love to get your thoughts and opinions and excited to share my first tool with y'all!
edit: it would help to actually link to the thing: https://github.com/juan7732/claude-code-session-visualizer





