Merfolk is a collaborative diagram workspace for teams working with agents. It gives the people who understand the work one place to create, discuss, and evolve diagrams together.
The product is the workflow around the diagram, not a particular syntax or rendering technology. Mermaid is the current source format, but the lasting value is keeping the shared picture close to reality.
Choose a starting point
- Web app overview — create and collaborate in the browser.
- Product quickstart — create, share, and improve your first diagram.
- CLI installation — install the terminal client.
- Agent overview — connect Merfolk to your coding workflow.
The improvement loop
- Create a diagram or start from existing source.
- Share it with the people who need to understand or improve it.
- Collect comments on the diagram itself.
- Have an approved editor interpret the feedback and update the diagram.
- Share the revised diagram and continue the conversation.
The loop works for process maps, architecture diagrams, system designs, customer journeys, operational workflows, and dependency maps.
Why teams use Merfolk
Teams already explain systems and work with diagrams. The problem starts after the first version: context gets lost in meetings and chat, the source lives in a repository or slide deck, and the diagram falls behind the work it is meant to explain.
Merfolk keeps feedback attached to the artefact. People who know the work can review the visual result without learning diagram syntax, while approved editors keep control of the source and the next update.
A simple first workflow
- Open the Merfolk web app.
- Map a process, system, customer journey, or operational workflow.
- Share the diagram with the people who know the work.
- Collect comments where the feedback belongs: on the diagram.
- Update the source when the team agrees on the next version.
Use cases
- Process mapping and maintenance
- Technical onboarding and knowledge transfer
- Architecture and system communication
- Product discovery and feature planning
- Cross-functional reviews across product, engineering, operations, and support
- Migration, launch, and incident planning
- Reusable playbooks for releases, onboarding, approvals, and support escalation
- Client workshops and asynchronous review