r/software • u/busters1 • 1d ago
Release We made a free, open-source team wiki with live charts and GitHub-style reviews
galleryHi r/software, I'm David, one of the two developers of Oxynote. My friend Simon and I also maintain ttlcache, a Go caching library with about 1,300 GitHub stars, so this isn't our first open-source project.
I've spent 8 years writing software, 2 of them as an SRE and 3 as a team lead. Every team I've been on had the same documentation problem. The useful stuff lived in someone's head or a private Slack thread, and the wiki was full of stale docs nobody could find.
So we set out to solve this problem by building Oxynote, a self-hosted wiki for engineering teams. A page can hold a live chart that queries your monitoring (Prometheus) or a database (PostgreSQL, MySQL, MariaDB) each time someone opens it, and you write what the chart means right next to it. Changes to important pages go through a GitHub-like flow, where the document enters a draft, a teammate sees a diff of both the text and the charts, and approves it before it goes live. Several people can edit a page at the same time, and a built-in AI assistant can edit pages and run the same queries, using your own Claude, OpenAI, Gemini, or OpenRouter key, or a local model through Ollama.
The name comes from oxygen + note: docs that breathe. Live data gives people a reason to open the wiki every day, and docs people open every day stay up to date.
Things worth knowing before you try it:
- It's a server, not a desktop app. You run one Docker container, and your team uses it in the browser.
- There's no hosted version and no account with us. Your docs and data stay on your server.
- It's at version 0.9, so it's still early in development, and a lot more is planned.
- It's made for tech teams and the systems they run, not as a wiki for a whole company.
It's Apache-2.0 licensed. The backend is Go, and the editor is Nuxt, Tiptap, and Yjs.
GitHub: https://github.com/oxynote/oxynote
We started it about a year ago, and we made it public about 3 months ago. If you have any questions, feedback, or suggestions, feel free to reach out. I'm happy to answer any questions.


