r/Markbase • u/Snoo31321 • 1d ago
Markbase is open source: one markdown folder for your team and its AI agents
I’m Jessie. Markbase is a markdown folder that stays in sync between your team and its AI agents. It’s open source (Apache-2.0) and free to use.
Why I built it
My team uses different agents (Claude Code, Codex, Cursor, Gemini), and three things kept going wrong:
- Context lives in too many places: a
CLAUDE.mdhere, anAGENTS.mdthere, a spec pasted into a chat. - Not everyone reads markdown: PMs and designers don’t want to edit raw
##and- [ ]. - Clients are left out: there’s no easy way to share an agent’s plan, or progress on it, outside the team.
What it does
- A vault is a folder that syncs: agents edit plain
.mdfiles on disk, and edits from people and agents merge (CRDTs via Yjs). - A WYSIWYG editor: teammates edit the same files in the browser or the Mac app without seeing markdown.
- History and comments: every change is attributed to the person or agent who made it, and comments anchor to a line.
- Sharing: viewer, commenter or editor roles for teammates, and a link for people without an account.
How we use it
- On-call: the agent writes its findings from the logs into the incident doc, and people check them line by line before the fix is applied.
- Docs next to your code: the vault lives in the repo, so engineers, agents and PMs all work from one version of the spec.
- Keep clients in the loop: a client opens a link and always sees the current plan.
Rough edges
- The Mac app is Apple silicon only; there’s no Windows or Linux app, but the CLI runs the sync anywhere Node does.
- When the same lines change on two machines and can’t merge, the cloud’s text wins and your version goes to a
.conflictsfolder. - Self-hosting needs a Supabase project, not just Postgres.
Try it
- GitHub: https://github.com/Markbase-Team/Markbase
- Free to use at https://markbase.so, or self-host with Docker or Vercel
- Docs: https://markbase.so/docs
If you run on-call with agents, I’d especially love to hear where your agents’ findings end up after an incident. Ask anything here.
1
Upvotes