What is md-log?

md-log is a human-in-the-loop review and archive layer where an AI coding agent writes its work as Markdown (.md) reports over MCP, and a person reviews them on web, mobile, or tablet, annotating with a pen, while every save becomes an immutable version.

md-log in one line

md-log is a review viewer and archive layer where an AI coding agent writes its work and analysis as Markdown (.md) reports, and a person comfortably reads, reviews, and approves those reports on web, mobile, or tablet. The agent saves reports by file path over MCP, reviewers annotate with a pen (S-Pen or Apple Pencil), and every save piles up as an immutable version.

The whole idea fits in one line: you review the REPORT, not the diff. md-log is not an automated code reviewer that judges your code for you — it is a review and record-keeping tool that supports human judgment.

The problem it solves — the vibe coding review bottleneck

In so-called vibe coding — where you steer an agent in natural language and it generates code in bulk — it is effectively impossible for a person to read every diff line by line. The volume is large, the context is scattered, and review is tied to the IDE at your desk.

As a result, reviews become perfunctory, and there's no lasting record of what the agent changed, why, and with what impact — so a teammate or a new agent later loses the context.

The solution — review the report, let a human decide

md-log moves the unit of review from the diff to the report. The agent leaves a Markdown report summarizing WHAT / WHY / IMPACT, and a person reads it and approves or rejects. The decision-maker is still the human (human-in-the-loop); md-log simply swaps the surface your eyes land on — from a pile of diffs to a readable document.

How it works, at a glance — 3 steps

  1. The agent writes a report. MCP clients like Claude Code, Claude Desktop, OpenAI Codex, and Cursor connect by URL (https://mcp.md-log.com/mcp) — no install — and each time they finish a task they save a .md report by path. Folders are auto-created on save (like mkdir -p), and images upload too.
  2. You review and annotate. Read the report on the web app, mobile, or tablet; on pen-capable tablets you hand-annotate with a stylus. See Review & annotation.
  3. It accumulates as immutable versions. Every save becomes a new version, so your project's AI-collaboration history builds up — doubling as onboarding material for new teammates or new agents.

Three tracks — Individual, team collaboration, and On-Premise

md-log comes in three tracks.

IndividualTeam collaborationOn-Premise
DeliveryOperator-hosted SaaS, freeOperator-hosted SaaS, freeSelf-hosted
People1 personUp to 5 members per teamNo member limit
Getting startedSign up at app.md-log.com → mint your MCP key in Settings → TokensSign in, create a team, invite teammates by emailContact sales to adopt
Where data livesOperator's serversOperator's serversBehind your firewall, on your own infrastructure
Best forSolo or small experiments, start instantlyA small team reviewing and annotating reports togetherMore members, or keeping reports carrying code context and decisions (IP) out of an outside cloud
Sign-upNo credit card, no sales inquiryNo credit card, no sales inquiryContact us

Team collaboration is a free feature inside the hosted SaaS, with up to 5 members per team. Share a document or a whole folder (its entire subtree) into a team, and members read the reports, editors and above save new versions, and everyone sees each other's pen annotations pinned to the version. For the details, see collaboration. When you need more members or want reports kept behind your own firewall, move up to On-Premise self-hosting.

Key concepts

  • MCP auto-collection: Add one rule to your agent rules file (CLAUDE.md for Claude Code, AGENTS.md for Codex, project rules for Cursor) and the agent writes a report after each task — no need to say "save this" every time.
  • Immutable versions: Every save, update, and append becomes a new version, and its commit_message shows up in the version history. Moving or renaming preserves history and annotations.
  • Multi-device + stylus annotation: Review on web, iOS, and Android (phones and tablets); on pen-capable tablets, hand-annotate with an S-Pen or Apple Pencil. Annotations are pinned to a specific document version.
  • Team collaboration (free): Create a team, invite teammates by email (up to 5 members per team), and share documents or folders to review and annotate together — shared reports show up in the web file browser and in a dedicated mobile tab. See collaboration.
  • Project memory / onboarding: The reports that accumulate become your project's AI-collaboration history, helping new teammates and new agents get up to speed fast.

Who it's for

md-log is for developers, tech leads, EMs, and small teams running a plan → review → approve loop with an AI coding agent. It's especially useful for reviewers who want to vet an agent's work asynchronously — on a tablet, away from the desk.

Next steps

Frequently asked questions

What exactly is md-log?

md-log is a human-in-the-loop review and archive tool where an AI coding agent writes its work and analysis as Markdown (.md) reports over MCP, and a person reviews them on web, mobile, or tablet, annotates with a pen, and every save accumulates as an immutable version. The core idea is that you review the report, not the diff.

Is md-log a code review tool? Does it review my code for me?

No. md-log is not an automated code reviewer; it is a review viewer and archive. A person reads the report the agent leaves and approves or rejects it, and the decision always rests with the human (human-in-the-loop).

What is vibe coding?

Vibe coding is a way of working where a person steers an AI coding agent in natural language and the agent generates code in bulk. Because it's hard to read every diff line by line, md-log moves the unit of review from the diff to the report.

Is md-log free?

Individuals can use the operator-hosted SaaS for free — sign up at app.md-log.com and mint your own MCP key in Settings → Tokens, with no credit card and no sales inquiry. Team collaboration is also free in the same hosted SaaS for up to 5 members per team; when you need more members or want data kept in-house, you scale up to self-hosted On-Premise.

Can I use md-log with a team?

Yes. Inside the free hosted SaaS you can create a team, invite teammates by email (anyone who already has an md-log account, up to 5 members per team), and share documents or folders to review and annotate together. If you need more members or want data kept in-house, you can move up to On-Premise. See the collaboration doc for details.

Which AI agents does it work with?

md-log works with Claude Code, Claude Desktop, OpenAI Codex, Cursor, and any other MCP client. You connect with a single command, npx -y md-log-mcp, and only need two environment variables: MDLOG_API_BASE_URL and MDLOG_PAT.