I've had a fairly thorough exploration of how I can give my agent a whiteboard so we can work on architectures together. To my surprise, current solutions (including Excalidraw) were not good enough and didn't deliver what I wanted. I ended up finding Mermaid to be the most agent-friendly medium and coded an Obsidian plugin for it. It works okay; we can work on the same doc while I bring my own AI agent, and we can brainstorm together.
https://community.obsidian.md/plugins/mermaid-relay
Show HN: Reladraw – A diagram language where you decide where to place things[1], which adds relative placement constraints, and provides agent skills. Nearby on the front page just now, fwiw.
YMMV, but the value I get from producing a diagram is derived from the thinking. Thinking about what I'm trying to draw leads to understanding about where my/my team's knowledge is poorer, what assumptions we're making, etc.
I found a big part of the appeal with tools such as Excalidraw is that people are still more willing to engage with your content because they think that its made by hand.
Compare a piss-tinted LLM-generated diagram with 80 pipes, flows and generic names everywhere to a seemingly hand-drawn sketch.
I have had my Exaclidraw connected to an agent through their MCP and I have gotten way more attention/time/reads on both blogs and papers because of the illusion of being human-made/hand-drawne making it more palatable.
The mindset that "everyone else is doing it" or "if I don't do it someone else will" is common amongst psychopaths and it reveals a deep cynacism and lack of consciousness. Often, the person is wrong as well.
I don't remember who said it, but someone mentioned that mathematics papers don't read well because the models don't know which parts to emphasize and which parts to gloss over. I would imagine similar tendencies here.
Yeah I tend to make my diagrams either as I go, as exploration, or after I'm done figuring things out as a summarizing artifact (and agents are great at using Mermaid to do that second one).
This is crazy. My claude chess stuff is (edit: was) currently near yours on the front page and noticed your post. I have a project very close than yours that I hesitated to share. From a quick glance, we went for a similar approach. I just open sourced it so that you can compare implementation notes. https://github.com/brumar/whiteboard-agents . It's not thoroughly tested but can be interesting to check.
Posted this somewhere else aswell but I've had good success with https://whiteboard-mcp.com - it seems to work better than other free alternatives for things like architecture diagram creation
I have a personal experience that there is a lot of attention be gained/exploited with tools such as Excalidraw because people still don't understand that this is possible to automate, and people with an LLM-negative bias that are actively against generated content will still give attention to such tools because it looks hand-drawn.
For example /r/art banned AI-generated content without a process due to this anti-automation bias, however you can now generate the process by using MCP-server tool calls into the software.
So there is a big attention market as long as you can keep up with things that seemingly looks like they had human effort.
What frustrates me about many projects is it's never been easier to just make a quick video or image or gif and put it in the README to show what the value is. This was at least somewhat complex before AI but now you can just paste an image and have the AI put it in your README.
I guess the frustrating bit is that the readme is 100s of lines long. AI is already saving you so much time on a project like this but you still make me clone and spin it up if i want to see it for real.
I get that open source is a gift and you’re not obliged to do anything I say but please consider taking the extra few minutes on your next project.
Wow, I just can't agree with this take at all. The README is only 161 lines (very short for a git repo README!) and took me about 15 seconds to skim and decide whether or not it was interesting enough to keep the tab open.
Most of the project pages I have seen with videos either animate things at hyper-speed, meaning you can't actually follow is what happening, or drag on for minutes just to communicate something that I could have read in seconds. My time is more valuable than that.
Images are cool, however. We should do more of those.
To that end, I've found it super easy to tell $LLM to make me a video showcasing the main features of whatever I'm building, have it write subtitles and give it a voice over. Obviously for a README a simple gif with burned in subtitles/annotations would be more useful.
Especially if the project is web-based it can just spin up playwright and record its actions.
I’ve been trying to find the best practice to connect a person’s existing ChatGPT/Codex / Claude accounts so they can be used in an app for the agent in the app.
Any advice? Everything seems clunky, even the best MCP efforts
Right I've already got MCP integration but it seems quite clunky. Do you have an example of an MCP implementation that you like? and maybe an example of code you used that did the integration nicely? Would love some pointers
best approach is to create an webapp that uses WebMCP and then use ChatGPT Desktop. you open the app using it and it and it can use all the tools. Then you implement navigation in the tools and you will see ChatGPT using your app pairing with you.
Right I've already got MCP integration but it seems quite clunky. Do you have an example of an MCP implementation that you like? and maybe an example of code you used that did the integration nicely? Would love some pointers
I am working on a similar thing for jsoncanvas (.canvas files in Obsidian). My takeaway is that agents are heavily trained on specific formats (e.g. svg), and are conversely pretty bad at niche formats. My strategy was to create a native renderer [1] so that at least they can rapidly iterate "visually" by reading svg and png renders instead of trying to one-shot.
I have yet to see an AI generated visual diagram that doesn't feel like slop though...
I'd be very interested in examples of actually-good diagrams workflows if anyone has seen them.
tldraw has a lot of programmatic access I have not compared it to excalidraw but there is still no equivalence between the model capabilities to build amazingly detailed infographics and diagraming tool use which is a gap I hope will narrow
Excalidraw offers their own open source first party MCP endpoint[0] and server[1]:
[0]https://mcp.excalidraw.com
[1]https://github.com/excalidraw/excalidraw-mcp
I've had a fairly thorough exploration of how I can give my agent a whiteboard so we can work on architectures together. To my surprise, current solutions (including Excalidraw) were not good enough and didn't deliver what I wanted. I ended up finding Mermaid to be the most agent-friendly medium and coded an Obsidian plugin for it. It works okay; we can work on the same doc while I bring my own AI agent, and we can brainstorm together. https://community.obsidian.md/plugins/mermaid-relay
Show HN: Reladraw – A diagram language where you decide where to place things[1], which adds relative placement constraints, and provides agent skills. Nearby on the front page just now, fwiw.
[1] https://news.ycombinator.com/item?id=49858513
Did you play with TLDraw at all? I’ve had some success with it but haven’t been using it for that particular use case.
i found it a bit later than others and didn't really explored it deep; but yeah still couldn't find what i was looking for out of the box
YMMV, but the value I get from producing a diagram is derived from the thinking. Thinking about what I'm trying to draw leads to understanding about where my/my team's knowledge is poorer, what assumptions we're making, etc.
I found a big part of the appeal with tools such as Excalidraw is that people are still more willing to engage with your content because they think that its made by hand.
Compare a piss-tinted LLM-generated diagram with 80 pipes, flows and generic names everywhere to a seemingly hand-drawn sketch.
I have had my Exaclidraw connected to an agent through their MCP and I have gotten way more attention/time/reads on both blogs and papers because of the illusion of being human-made/hand-drawne making it more palatable.
‘I found a new way of wasting people’s time with my slop’ god this is bleak.
Attention is the only currency when you have free information generation. Take it with whatever means, or someone else will.
The mindset that "everyone else is doing it" or "if I don't do it someone else will" is common amongst psychopaths and it reveals a deep cynacism and lack of consciousness. Often, the person is wrong as well.
I don't remember who said it, but someone mentioned that mathematics papers don't read well because the models don't know which parts to emphasize and which parts to gloss over. I would imagine similar tendencies here.
Yeah I tend to make my diagrams either as I go, as exploration, or after I'm done figuring things out as a summarizing artifact (and agents are great at using Mermaid to do that second one).
Yes I agree! Drawing helps me think.
This is crazy. My claude chess stuff is (edit: was) currently near yours on the front page and noticed your post. I have a project very close than yours that I hesitated to share. From a quick glance, we went for a similar approach. I just open sourced it so that you can compare implementation notes. https://github.com/brumar/whiteboard-agents . It's not thoroughly tested but can be interesting to check.
Posted this somewhere else aswell but I've had good success with https://whiteboard-mcp.com - it seems to work better than other free alternatives for things like architecture diagram creation
I have a personal experience that there is a lot of attention be gained/exploited with tools such as Excalidraw because people still don't understand that this is possible to automate, and people with an LLM-negative bias that are actively against generated content will still give attention to such tools because it looks hand-drawn.
For example /r/art banned AI-generated content without a process due to this anti-automation bias, however you can now generate the process by using MCP-server tool calls into the software.
So there is a big attention market as long as you can keep up with things that seemingly looks like they had human effort.
What frustrates me about many projects is it's never been easier to just make a quick video or image or gif and put it in the README to show what the value is. This was at least somewhat complex before AI but now you can just paste an image and have the AI put it in your README.
I guess the frustrating bit is that the readme is 100s of lines long. AI is already saving you so much time on a project like this but you still make me clone and spin it up if i want to see it for real.
I get that open source is a gift and you’re not obliged to do anything I say but please consider taking the extra few minutes on your next project.
Wow, I just can't agree with this take at all. The README is only 161 lines (very short for a git repo README!) and took me about 15 seconds to skim and decide whether or not it was interesting enough to keep the tab open.
Most of the project pages I have seen with videos either animate things at hyper-speed, meaning you can't actually follow is what happening, or drag on for minutes just to communicate something that I could have read in seconds. My time is more valuable than that.
Images are cool, however. We should do more of those.
To that end, I've found it super easy to tell $LLM to make me a video showcasing the main features of whatever I'm building, have it write subtitles and give it a voice over. Obviously for a README a simple gif with burned in subtitles/annotations would be more useful.
Especially if the project is web-based it can just spin up playwright and record its actions.
https://likec4.dev/ It's a bit different usecase, but llms are proficient with it
I’ve been trying to find the best practice to connect a person’s existing ChatGPT/Codex / Claude accounts so they can be used in an app for the agent in the app.
Any advice? Everything seems clunky, even the best MCP efforts
MCP is the answer but it's only really worth it if you product is reasonably complex e.g. n8n has a community MCP fully for this reason.
Right I've already got MCP integration but it seems quite clunky. Do you have an example of an MCP implementation that you like? and maybe an example of code you used that did the integration nicely? Would love some pointers
I played around a bit with pencil.devs mcp integration before: https://www.pen.dev/
Which was at least fun for a bit although I failed to really see the use after models became better at designing themselves.
best approach is to create an webapp that uses WebMCP and then use ChatGPT Desktop. you open the app using it and it and it can use all the tools. Then you implement navigation in the tools and you will see ChatGPT using your app pairing with you.
Right I've already got MCP integration but it seems quite clunky. Do you have an example of an MCP implementation that you like? and maybe an example of code you used that did the integration nicely? Would love some pointers
video https://lnkd.in/p/ez4EZede
I am working on a similar thing for jsoncanvas (.canvas files in Obsidian). My takeaway is that agents are heavily trained on specific formats (e.g. svg), and are conversely pretty bad at niche formats. My strategy was to create a native renderer [1] so that at least they can rapidly iterate "visually" by reading svg and png renders instead of trying to one-shot.
I have yet to see an AI generated visual diagram that doesn't feel like slop though... I'd be very interested in examples of actually-good diagrams workflows if anyone has seen them.
[0] https://jsoncanvas.org/
[1] https://github.com/dtkav/canvas-native
tldraw has a lot of programmatic access I have not compared it to excalidraw but there is still no equivalence between the model capabilities to build amazingly detailed infographics and diagraming tool use which is a gap I hope will narrow