About

codissy started in late 2024 as a personal yak-shave and grew into something that a few friends and their teams now rely on. It is not a startup, has no roadmap, and is unlikely to develop one.

The why

At work I spent more incidents than I'd like to admit piping log streams through increasingly long chains of jq, grep, awk, and eventually python -c "<200 lines>" just to answer questions like "which endpoint was slow during the spike?" or "was the 5xx burst correlated with one customer?".

I tried the SaaS log platforms. They're good. They're also expensive, and they assume the log line you actually need has already been shipped, which during an incident feels like betting against yourself.

codissy is a tiny middle ground: a single binary you scp onto a box, that turns a firehose of JSON or logfmt into something that fits on a screen.

Design principles

• Unix pipes are the contract. stdin in, stdout out. No daemons, no agents, no API keys.
• Be a tool, not a platform. If you find yourself wanting a feature so you don't have to learn grep, that's a sign codissy should not have that feature.
• Sensible defaults. The most common query ("what's breaking right now") should be the shortest command.
• No telemetry, no auto-update, no analytics. The binary phones home only if you explicitly tell it to (you can't).

Who maintains it

Mostly me, with patches from people who've been kind enough to send them. I have a day job, so reviews can take a week or two. Bug reports with reproduction steps are the path of least resistance — please include the input format and a representative line.

Getting in touch

Bug reports and feature requests go on the issue tracker. For anything else, email hi [at] codissyxy [dot] top. I try to reply within a few days but the queue depth depends on what's on fire that week.

For commercial support (e.g. you'd like a feature added or a release pinned for your environment), get in touch and we'll work something out. I'm not pretending to run a business — but I do appreciate the offer when it's on the table.

License

codissy is released under the MIT license. You can use it for whatever you like, including embedding it in commercial products, with no obligation other than keeping the license file intact.

Acknowledgements

Thanks to everyone who's reported bugs, sent patches, or just told me the tool was useful — that last category is the reason I keep working on this on weekends.

Special thanks to the lipgloss, kong, and simdjson-go projects, on whose shoulders codissy stands.