Request: Document Claude Code internals

[hesreallyhim]

More and more projects are springing up on top of Claude Code, and in particular on top of the undocumented un-public parts of CC that live inside ~/.claude (or whatever the directory happens to be today). E.g. there's probably half a dozen "usage trackers" that are built on top of the jsonl log files - but that's not part of the public API, and could by all rights be removed in the next release even without being noted in the changelog. So those projects are really brittle.

This is not "fair" anymore. People are putting too much effort to make Claude Code an even more awesome tool. It's bringing in more and more people into the ecosystem. Contributors are doing loads of work for free to make Claude Code a better app.

Please incorporate the jsonl part of the system into the public API and document it, just like CLAUDE.md and other official configuration files. It's an important part of how CC works, people are building things on top of it, and it's not in any way "hidden" (doesn't involve "reverse engineering" to figure out what they're doing). The way it is now, they are benefitting off of the work of contributors who cannot be confident that their projects won't break by the next release without being informed.