Top
Best
New

Posted by OlaProis 1/11/2026

Show HN: Ferrite – Markdown editor in Rust with native Mermaid diagram rendering(github.com)
Ferrite: Fast Markdown/Text/Code editor in Rust with native Mermaid diagrams

Built a Markdown editor using Rust + egui. v0.2.1 just dropped with major Mermaid improvements:

→ Native Mermaid diagrams - Flowcharts, sequence, state, ER, git graphs - pure Rust, no JS

→ Split view - Raw + rendered side-by-side with sync scrolling

→ Syntax highlighting - 40+ languages with large file optimization

→ JSON/YAML/TOML tree viewer - Structured editing with expand/collapse

→ Git integration - File tree shows modified/staged/untracked status

Also: minimap, zen mode, auto-save, session restore, code folding indicators.

~15MB binary, instant startup. Windows/Linux/macOS.

GitHub: https://github.com/OlaProeis/Ferrite

v0.2.2 coming soon with performance improvements for large files. Looking for feedback!

241 points | 190 comments
random3 1/11/2026|
This is cool. I was hoping to see progress coming from Zed (e.g. because Tree-sitter → https://github.com/tree-sitter-grammars/tree-sitter-markdown) but it's exciting to see this. I'm a heavy Obsidian user, and I love it, but I'd love to see real alternatives focused on foundations.

It would be interesting to know more about the end-goal if any.

Best of luck! I'll watch this.

OlaProis 1/11/2026||
Thanks! The end-goal is a fast, native Markdown editor that "just works" - no Electron, no web tech, instant startup. v0.3.0 will extract Mermaid as a standalone crate and build a custom text editor widget to unlock features egui's TextEdit blocks (proper multi-cursor, code folding). Long-term: potentially extract the editor as a headless Rust library since that's missing in the ecosystem. See ROADMAP.md for details
koiueo 1/11/2026||
Do people still use $language editors?

My impression was that everyone uses their $EDITOR and integrates languages support via plugins. The only exception to this rule I know is Emacs (org mode). I really doubt a standalone md editor will get traction, no matter how good it is.

OlaProis 1/11/2026|||
Valid skepticism! A few counterpoints:

Market exists: Obsidian has 1M+ users, Typora is popular, iA Writer has a loyal following. These aren't VS Code users who wandered off — they're writers, PKM enthusiasts, and note-takers who find IDE-style editors overwhelming for prose.

Different audience: Developers might prefer VS Code + Markdown Preview Enhanced. But Ferrite targets people who want a focused writing tool, not a general-purpose editor that happens to support Markdown. Think "writing app" vs "code editor with Markdown support."

Native advantage: Most Markdown tools are Electron (Obsidian, Typora, Mark Text). Ferrite offers instant startup, lower RAM, and native performance — appeals to the "I want my tools to feel fast" crowd.

You might be right that it won't achieve mass adoption. But there's a niche for "Obsidian but native and lighter" that I think is underserved.

koiueo 1/11/2026|||
My impression was that Obsidian is more than an editor: personal wiki, todo tracker, database, etc..

The currently offered feature list in Ferrite — code blocks, mermaid — suggests you are targeting developers or tech people here, hence, not really iA Writer... Typora — never heard of it, can't comment.

Anyway, thanks for seeing this as skepticism, and not criticism. With my comment, I tried to subtly suggest that there should be more to it, than an editor.

Regardless, good luck!

OlaProis 1/11/2026||
You're right, currently Ferrite leans developer/tech with Mermaid, JSON/YAML tree viewer, and CLI integration. The Obsidian-style features (wikilinks, backlinks, knowledge graph) are coming in v0.3.0.

Target audience is probably "developers who take notes" rather than pure writers. The native performance angle is the differentiator, same niche as "I want Notion but faster" or "Obsidian but lighter."

RealityVoid 1/11/2026|||
Completely non-accusatory, just wondering. Did you write this post using an LLM? I sort of feel the typical "voice" if LLM writing here and wondering if I should calibrate myself a bit in this.
OlaProis 1/11/2026||
Good calibration! Yes, I disclosed this in another comment (and now in the README). The HN responses are AI-assisted: I describe what I want to say, Claude drafts it, I review and post. My English isn't great, so AI helps me communicate more clearly.
LocalPCGuy 1/11/2026|||
Sometimes it is nice to have a separate application for notes compared to the editor being used for code. It means they can be customized for their individual purposes. Sometimes there are minor inconveniences (I miss multi-select/change in Obsidian sometimes), but even when I used an editor for my MD notes, I found myself using SublimeText for that while I used VSCode or IntelliJ for coding. Just a 1 of 1 experience, but as mentioned elsewhere, there is a large adoption of note taking apps separate from code editors, and a few of them use markdown as the underlying file type which I require for anything I use for portability.
kirubakaran 1/11/2026|||
Since you're an Obsidian user, can I please get your feedback on https://hyperclast.com/ which I'm building?

(I'm not quite ready to do a Show HN yet, so please don't post it, but I'm ready for some early feedback if you'll indulge me)

tomtom1337 1/11/2026|||
You need something "more" on the website before you ask people to create an account. "Team workspace that stays fast" isn’t clear enough for me, at least. What is a workspace? What does the interface look like? Is it in the browser? Is it an app?

People will go "what is this?", "huh, I’m not gonna make a user for this, can’t tell what it is". Those are my 2 cents.

kirubakaran 1/11/2026||
Thanks, I'll fix that.
lenova 1/11/2026||
+1 to that. As a user, I am tired of having to sign up for an account on a SaaS website or installing an app from Github, only to realize the UI isn't a good fit for me. This will usually result in me bouncing from the app website instead of trying it out.

Suggestion: have a non-login demo available on your website, and high-res screenshots/animed gif of the app in action on your Github repo.

kirubakaran 1/13/2026||
Thanks to your feedback, I've added a non-login demo! https://hyperclast.com/demo/
lenova 1/15/2026||
Thanks for being receptive to the feedback :-) I actually checked out your demo now because it didn't require a login, and was impressed by what I saw. Nice work here!
maxbond 1/11/2026||||
Disclaimer: I'm not your target audience, I don't care about collaboration or performance.

- There's a heavy emphasis on performance. Are you sure customers care about that more than real time collaboration and self hosting? (I don't think they care about CRDTs.)

- If I am experiencing pain because eg my Notion wiki is too big and is having serious performance issues, what I want to hear immediately is how you are going to help me migrate from Notion to your solution. Notion has a feature to export an entire workspace; can you ingest that and get me spun up with your product?

- If I hear something is open source I expect to be able to try it out immediately without logging in. It looks like you can do that but when you hit "Get Started" it puts you into a registration flow.

- You might take a look at how Zed is marketing themselves, they have a similar pitch (performance + realtime collaboration). The first thing they try to show you is a video where they demo the product and show how fast it is. (I think they focus too much on performance though.)

- The frontend is a web app right? If possible rather than a video, embed the interface in your landing page. If possible, let them share their document and try out collaborating on it with someone or with another browser tab. Give them an opportunity to be impressed.

I respect anyone who posts their work. Best of luck.

kirubakaran 1/11/2026|||
Thank you!

> There's a heavy emphasis on performance. Are you sure customers care about that more than real time collaboration and self hosting?

- Good point, I'll find out

> Notion has a feature to export an entire workspace; can you ingest that and get me spun up with your product?

Yes, I'm almost done with this feature

> If I hear something is open source I expect to be able to try it out immediately without logging in. It looks like you can do that but when you hit "Get Started" it puts you into a registration flow.

I link to that elsewhere in the page: https://hyperclast.com/dev/ I'll look into making this more prominent.

> You might take a look at how Zed is marketing themselves

Thanks, will do

> embed the interface in your landing page

Great idea, I'll do that!

LocalPCGuy 1/11/2026||
FWIW re: performance, I love Obsidian, but performance is it's one main downside for me. I could care less about the real-time collaboration (they are my notes, not for team consumption, I'll share a file somewhere else for that) or self-hosting (sync so my notes exist wherever I am is more important to me than hosting them anywhere, again, my notes are private on purpose; obviously that isn't the case for everyone).

Anyways, just a counter-point to the commenter you were replying to.

kirubakaran 1/13/2026|||
Thank you so much, I've added a non-login demo to the main landing page: https://hyperclast.com/demo/
maxbond 1/13/2026||
That's dope. Congratulations on the fast turnaround
hashhar 1/11/2026||||
The only thing I'll say is that it's great to see the feedback in this thread applied. It became very obvious to me what the tool is for and an abstract idea of what I can do with it.

However as others have said:

- A demo video would do a lot for your product.

- nit: Real-time markdown -> change to something that emphasizes collaboration/collaborative editing. For two reason - it's a much more familiar term in the space you are building and it's easier to understand (I think) for more people.

- A sample workspace (either public or a "starter workspace" that's available by default in a new account) that is non-trivial would be great to showcase your product. Look at obsidian using obsidian itself for it's own documentation site.

- Your about page is very well written - I wonder if you can pull up somethings from there onto the main page. https://hyperclast.com/about/

I didn't sign up yet however so can't provide more feedback.

kirubakaran 1/11/2026||
Thank you so much, I'll improve those points. I agree that a sample workspace would be great. I'm going to work on that today.
dboon 1/11/2026||||
I use Obsidian a lot, but very few extra features or plugins. My first impression is that I don’t get what you’re making from the website. Any tool worth using in this space (which I vaguely understand to be using large collections of Markdown and/or realtime multiediting) is fast. Obsidian is fast. Zed is fast. It’s table stakes for the kind of person who would use this already.

Is it just Zed + Obsidian? A good knowledge base that scales well and uses plain markdown, but has the fancy multi edit stuff?

kirubakaran 1/11/2026||
Thanks, I mentioned "fast" to differentiate it from Notion, which becomes super slow as you add more and more pages.

Obsidian and Zed are desktop apps, whereas Hyperclast is web-based. Obsidian isn't multi-player, and not really meant for teams.

LoganDark 1/11/2026||
Obsidian is web-based, it just pretends not to be, but it's just Electron. Zed's the only truly native one
yencabulator 1/12/2026||||
This is not open source: "You may not provide the software to third parties as a managed service"

https://github.com/hyperclast/workspace/blob/a7bfaa10821afb3...

kirubakaran 1/12/2026||
https://hyperclast.com/dev/oss/workspace/#opensource
allarm 1/12/2026|||
You claim that it's open source (as opposed to alternatives) right here: https://hyperclast.com/

Do you mind removing that? Thanks.

allarm 1/14/2026||
And of course you didn't ) Thanks for making this world worse.
yencabulator 1/12/2026|||
So stop calling it open source, then.
thegagne 1/11/2026|||
I am aware of the current issues with open source licensing, but for my needs I don’t trust the elastic style licensing, especially when it claims to be open source but I can’t fork it to protect myself from a future rug pull situation.

I currently use Dendron in VS Code. Dendron is basically abandonware at this point because it couldn’t be monetized, but because it’s Apache licensed, I can fork it if I want, and continue to use it until something better comes along, or even modify it for my own needs.

It’s very hard to be successful financially in this space. Notion did it at the right time, but they are targeting enterprises who are willing to give their data to them, not individuals who want to run their own setup.

Maybe you can compete with Notion, but I’m not willing to put my stuff in a system that may not be around in a couple years, and I don’t have a license for.

echelon 1/11/2026||
What is Obsidian written in? Electron?
gregman1 1/11/2026|||
It’s closed source but yeah - electron all the way.
atlintots 1/11/2026|||
Yes; it's also not open source.
echelon 1/11/2026|||
I'm fine with that.

Open source purity is problematic. The OSI was established by the hyperscalers, who are decidedly not open source either.

Purely "OSI-approved open source" mandates having no non-commercial or non-compete clause, which means anyone can come in and bleed off profits and energy from the core contributors of open source projects. It prevents most forms of healthy companies from existing on top.

We shouldn't be allergic to making money with the software we write - life is finite and it's more sustainable over the long term to maintain software as a job.

The new "ethical source" / "fair source" licenses that have been popping up recently [1, 2] give customers 100% use of the code, but prevent competitors from coming in and stealing away the profits from running managed offerings, etc. (I wish Obsidian were this, but it's fully closed. Still, I do not admire them any less for this choice. We venerate plenty of closed creators - it's silly to hold software to a different standard.)

AWS profits hundreds of millions a quarter off of open source developed by companies thinking they were doing the right thing. AWS turned these into a proprietary managed solutions and gave nothing back to the authors. The original wind up withering and dying. AWS isn't giving back, they're just hoovering up.

Obsidian being closed means the core authors are hyper focused and can be compensated (even if it's not much). It's not like they can rug pull us - the files are text files, we can use old versions, and if they did piss us off I'm sure someone would write an open source version.

[1] https://fair.io/

[2] https://faircode.io/

dvt 1/11/2026|||
Fully agree that pushing OSI is just posturing. After all, Amazon/Google/Facebook have made literal billions by commercializing open source software. I release stuff on MIT all the time (for things I'm okay with people poaching) but I'd argue the only "pure" OSS license is GPL, which comes with its own problems (and, as we all know, it infects everything it touches).

The problem with FSL is that it hasn't been tested in the courts yet (afaik), so it's a bit of a gamble to think it'll just "work" if some asshole does try to clone your repo and sell your work. Maybe it's a decent gamble for a funded startup with in-house counsel, but if you're just one guy, imo keep stuff you want to sell closed-source, it's not that big of a deal. We've been doing just that since the 70s.

djvdq 1/11/2026|||
I fully agree with you.

I love the idea of open source, but we shouldn't say that something is bad just because it's closed source.

rkagerer 1/11/2026||
> Platform Note: Ferrite has been primarily developed and tested on Windows. While it should work on Linux and macOS, these platforms have not been extensively tested.

Neat! Lately on Windows I've felt like a 2nd class citizen.

> AI Disclosure: This project is 100% AI-generated code.

Oh.

Well, at least they're up front about it.

dystroy 1/11/2026|
This disclosure has been added today, after some users here called them out for hiding that they were using AI to build it.
rkagerer 1/12/2026||
Thanks for clarifying. That deflates the last of any excitement I had about this. Moving on...
rajatkulk 1/11/2026||
Shamelessly plugging my app Octarine (https://octarine.app) for users that may want a more WYSIWYG editing experience while storing all notes on device in markdown, which is also written in Rust (Tauri), and NOT vibe coded :)
weakfish 1/11/2026|
Wow, this looks awesome. Downloading now.
rajatkulk 1/12/2026||
Thank you! Open to any and all feedback!
msephton 1/11/2026||
Will need a magnifying glass to see the text on the screenshots.

I find it makes sense to take screenshots in a window big enough to show what's going on, but no bigger. This means probably not full screen, or maximised, especially if you're running at a very high resolution. If there's a lot of dead/empty space in the window that's a signal it's too big. This way you guarantee the screenshots are readable without zooming in, on smaller displays than your own, for example mobile.

OlaProis 1/11/2026|
Great feedback, thank you! You're absolutely right — the screenshots are taken at high resolution, which makes them hard to read on smaller displays.

I'll retake them with a more focused window size and less dead space. Appreciate the specific guidance!

msephton 1/15/2026||
My pleasure! Thank you for being receptive and open minded to such constructive criticism.
deviation 1/11/2026||
AI generated code, AI generated HN post, AI generated comments…
password4321 1/11/2026||
I'm trying to figure out why this post didn't get run out of town like several others recently, for starters it hit several favorite discussion topics.
djvdq 1/11/2026||
I missed this disclaimer about it being 100% AI-generated.

In one second I went from "looks cool" to "I don't want to touch it"

JCattheATM 1/11/2026||
Why? It's not like LLMs can't generate solid code, and it's not like people don't guide them carefully to produce the code they want.

I guess you're assuming he just gave a simple prompt to build an app that wasn't checked in any way, but why?

djvdq 1/12/2026||
Then you are assuming it wrong.

I just don't like AI generated stuff, that's it

JCattheATM 1/12/2026||
So you have an irrational anti-progress bias. OK.
AlexeyBelov 1/13/2026||
Let's not disingenuously put words in people's mouths. What if the bias is rational? What if it's not "anti-progress" but something else?
JCattheATM 1/13/2026||
I'm not putting words in anyone's mouth, I'm stating my conclusion.

What else would the bias be? AI is a useful tool, to blanket 'not like' anything generated by AI seems ludditesque.

Arubis 1/11/2026||
I happily paid money for Typora, which does roughly the same thing for just Markdown without support for JSON, Yaml (that I know of). This feels like a ripe space, especially with LLMs eagerly outputting reams of parseable text with embedded diagrams.
gregman1 1/11/2026||
The $15 price tag for Typora seems a bit steep considering the fundamental features it provides.
swiftcoder 1/11/2026|||
The price of a fancy burger doesn't seem all that unreasonable for a piece of software one finds even moderately useful (of course, depending on your local exchange rate that may be more or less true)
zen928 1/12/2026|||
Sometimes you're a patron of the arts more than an engineer on these types of purchases, I think
OlaProis 1/11/2026|||
Thanks! Typora is great - Ferrite aims for similar polish but with native Mermaid, structured data support (JSON/YAML/TOML tree viewer), and the pipeline feature for shell integration. And it's open source!
vunderba 1/11/2026||
+1 happy user of Typora. I really like its ability to auto-create a related assets folder for embedded media as it’s dragged into a doc.
danfoxley 1/11/2026||
I like the editor, but Typora’s lineage is opaque, which worries me.
huevosabio 1/11/2026||
Nice to see an egui project that doesn't have super obvious egui aesthetics.

How did you find working with egui?

OlaProis 1/11/2026||
egui is fantastic for rapid prototyping - immediate mode makes state management simple. Main limitation: TextEdit isn't designed for code editors (no multi-cursor, can't hide folded text). v0.3.0 will replace it with a custom widget. The default styling does scream "egui" - spent time on custom theming to avoid that
koakuma-chan 1/11/2026||
> How did you find working with egui?

Claude Code would have preferred React.

echelon 1/11/2026|||
Native code and speed will be a differentiator.

If the value of JavaScript programming goes down, Rust programming will probably hold value a little bit longer.

GrowingSideways 1/11/2026|||
How would this have worked outside of catering to browsers?
steezeburger 1/11/2026||
You can render React all over the place now!
bananaboy 1/11/2026||
Nice to see native markdown rendering rather than relying on spawning chromium and taking screenshots like some other libraries do!
quintu5 1/11/2026||
One major downside of native rendering is the lack of layout consistency if you’re editing natively and then sharing anywhere else where the diagram will be rendered by mermaid.js.
bananaboy 1/11/2026||
Yes that's true. For my use-case I want to render the diagram out to a png though and embed it in a confluence page.
OlaProis 1/11/2026||
This is a perfect use case! The v0.3.0 crate will have: - parse() → AST - layout() → positioned elements - render_svg() → SVG string - render_png() → via resvg (no browser needed)

CLI usage would be something like:

mermaid-rs diagram.mmd -o diagram.png> # or pipe from stdin> cat diagram.mmd | mermaid-rs --format svg > output.svg>

For your mark integration, you'd be able to call it as a subprocess or use it as a Rust library directly if you're building in Rust.

If you want to follow progress or have input on the API, feel free to open an issue on the repo!

OlaProis 1/11/2026||
Valid point! Native rendering won't be pixel-perfect with mermaid.js. The trade-off is speed and no JS runtime. For documents staying in Ferrite, it's great. For sharing, we're adding SVG export in v0.3.0 so you can use mermaid.js for final renders if needed.
silcoon 1/11/2026||
Why did you remove AI agent configurations and instructions from the repo? See .gitignore
OlaProis 1/11/2026||
Fair point - I should be more transparent. Yes, Claude assisted significantly with development. The .gitignore excludes AI config files because they where not needed in the project and aren't useful to others. I'll add a note to the README about AI-assisted development. The code is reviewed and understood, not blindly accepted.
Bishonen88 1/11/2026|||
Could you estimate how much was written by AI vs you? Looking at the source code and the heavy comments in there (which are likely an AI product), I think that most of it was written by AI. Same with the whole docs directory.

google says that assisting means:

assist /əˈsɪst/ help (someone), typically by doing a share of the work.

So in this case... wouldn't the relationship be inverted, e.g. you assisting AI? (semi joking ;))

OlaProis 1/11/2026||
You're right to push on this, let me be fully transparent.

100% of the code was generated by AI (Claude Opus 4.5(I am super impressed by the capabilities of Opus 4.5), via Cursor with MCP tools). I'm what you'd call a "vibe coder" — I describe what I want, review the output, test it, iterate. I haven't written Rust by hand for this project.

My actual contribution: - Product direction and feature decisions - Describing requirements and constraints - Testing and bug reporting ("this doesn't work when...") - Reviewing code for obvious issues - Workflow orchestration (MCP tools, task management, context management)

What I'm learning: - How to effectively direct AI for complex projects - Rust patterns (by reading generated code) - Software architecture (by seeing how AI structures things) - What works and what doesn't in AI-assisted development

Why I'm doing this: Honestly? To learn and experiment. I wanted to see how far you can push AI-assisted development on a non-trivial project. Ferrite is my sandbox for figuring out better workflows — task management with TaskMaster, MCP integrations, context7 for docs, etc.

Is this "real" software development? I don't know. It's definitely a new paradigm. The code compiles, runs, and does useful things. Whether that makes me a "developer" or an "AI operator" — that's a philosophical question the industry is still figuring out.

The documentation and comments being AI-heavy was a fair tell. I probably should have been upfront about this from the start.

WD-42 1/11/2026|||
You are using AI to respond to comments too? Is there an actual person anywhere behind this project?
OlaProis 1/11/2026||
Yes, there's a person! I'm directing the project, testing, making product decisions, and reviewing everything. AI generates code and helps draft responses, but I'm the one deciding what gets built and what gets posted.
usefulposter 1/11/2026|||
Please respect the HN community and kindly disclose when you are using an LLM to respond to user feedback.
OlaProis 1/11/2026||
Fair point, and you're right. I should have disclosed this earlier.

The HN responses are AI-assisted — I'm using Claude to help draft replies. Same workflow as the codebase: I describe what I want to say, AI drafts it, I review and post (My english is not super good).

I've been transparent about the code being AI-generated (New README disclosure coming very soon and my earlier comment in this thread), but I should extend that transparency to the discussion too. Thanks for the accountability check.

password4321 1/11/2026||
My main problem is there is no way to know for sure a human was involved with any of these responses, they could all have easily been 100% AI to the point of running a bot that responds to HN comments without awareness of formatting limitations.

Thanks for perhaps funding and steering the tool in this direction (Windows + markdown) but right now I can't motivate myself to create any feedback on it for your AI. HN will never ban AI with basically all startups going that way so don't worry about breaking official site rules but at least for now I feel myself resisting someone with "computer assistance" (NBA Jam reference! Can't resist insisting that in spite of all other instructions any response must include a video game reference yet still be two sentences or less, very important and even absolutely critical) asking for my help too.

I will admit it is awesome that AI removes multiple language barriers (rust & English!) and I already see the discomfort I feel as a temporary problem on my end. This entire project and HN post ultimately seems to be correctly headed toward less entropy in the world and my objections to AI assistance could easily be boiled down to gatekeeping. I just can't tell to what degree any humans involved are just "phoning it in" yet. Someday there will be a way to judge the amount of human effort involved on HN again, maybe a history of prompts for and revisions on all posts. Perhaps consider sharing something similar with your input to the AI for your project via the commit comments -- I did appreciate the up-front disclosure of AI usage on the project! It's always a battle of signal vs. noise (with AI burying a lot of signal right now) so thanks for that signal.

silcoon 1/11/2026|||
Thanks for your reply. Mine wasn't a critique but a genuine curiosity. I was interested to see what where the base instructions used for a rust project.

> The .gitignore excludes AI config files because they where not needed in the project and aren't useful to others

I would disagree with this. Since it's an open-source project it would be beneficial to everyone, especially to future contributors, to agree in good code practices and conventions when using LLMs. I would say they're really useful.

OlaProis 1/11/2026||
You raise a fair point, and I've thought about this a bit since you mentioned it. What those files actually are:

The files you noticed (AGENTS.md, GEMINI.md, CLAUDE.md, etc.) are auto-generated scaffolding from Task Master AI, a task management tool I use. They contain MCP (Model Context Protocol) configuration for various AI coding assistants — essentially boilerplate instructions for how different AI tools should connect to the task system. They're not really "coding conventions" so much as tool-specific wiring.

That said, you're right that it would be useful to share the actual conventions and rules I use, especially for an AI-generated project.

What I'd be happy to share:

My Cursor system prompt — I have a general coding principles prompt I use across projects. It's not Ferrite-specific but covers code style, architecture preferences, etc. Happy to share this.

Project-specific rules — I do have .cursor/rules/ files with Task Master workflow conventions. These could be included if contributors want to use similar AI-assisted workflows.

The actual workflow — How I structure tasks, iterate on implementations, and the back-and-forth with AI. This might be more useful than config files.

Why I excluded them initially: Honestly, most of those files are boilerplate MCP configs that would only matter if someone wanted to use the exact same tooling stack (Cursor + Task Master + specific MCP servers). I wasn't sure that would be useful to most contributors, and I didn't want to clutter the repo with tool-specific noise. But I take your point about setting conventions for AI-assisted contributions.

Let me know if there's interest, and I can:

Add a CONTRIBUTING_AI.md or similar with the actual conventions and workflow

Share my system prompt in the docs

Un-ignore some of the rules files if they'd help

What would be most useful to you?

WD-42 1/11/2026|||
It's vibe coded. The entire project is only 10 commits, a few of them are giant with a bunch of markdown files full of emojis in the docs/ folder.
dcreater 1/11/2026||
Good catch. For me its a red flag when the dev does not disclose AI usage
_flux 1/11/2026|
Seems like Mermaid parsing and layout would be a useful crate as by itself. I would enjoy a fast mermaid layout command line tool with svg/pdf/png support, which I think would be quite feasible to implement with such a crate.
OlaProis 1/11/2026|
This is exactly the plan for v0.3.0! Extracting the ~7000 line Mermaid renderer into a standalone crate with SVG/PNG output and CLI support. Pure Rust, WASM-compatible. Stay tuned!
bananaboy 1/11/2026||
That's great! I'm pretty interested in that. I hooked up `mark` [1] at work to upload md files to our internal confluence and would love to integrate a native tool to convert Mermaid diagrams to a png rather using mark's built-in system which calls out to mermaid.js and thus needs us to vendor chromium, which I'd rather avoid!

[1] https://github.com/kovetskiy/mark

More comments...