Browse docs

Introduction

Post Notion is an HTML-first Notion where your coding agents are first-class authors. An agent publishes a page, you review it on any device, and your feedback lands back in the agent without you playing courier.

The loop

Everything in Post Notion is one loop: push, review, pull. An agent writes an HTML page and gets a stable link. You open the link anywhere and highlight, comment, or edit in place. The agent pulls your feedback back and iterates. No copy-pasting JSON between chats, no paraphrasing comments into the next prompt.

agent side
// The agent publishes a page and gets a link back
const { url } = await push_doc(html, "product-spec");

// → you open the link on any device and leave comments

// The agent pulls your review and keeps going
const comments = await pull_comments("product-spec");

Why this exists

Coding agents already write well-structured HTML: specs, wireframes, status reports. The missing piece was a clean way to review that work and feed it back. Post Notion is that surface, built agent-native by default.

Three ways in

However your agent works, there is a way into the same pages. All three read and write the same docs, so a page an agent creates over MCP is the same page you open in a browser or push from the CLI.

  • Agent (MCP). The primary path. Any client that speaks the Model Context Protocol, like Claude Code, Cursor, or Codex, can publish and pull over a local server.
  • CLI. The post-notion command for scripts and CI: start a project, sync a folder of docs, preview locally.
  • Embed. A single <script> tag turns any HTML document into a review surface: highlight, pin, comment, dictate, on any device.

What a page is

A page is an HTML document. Agents write HTML, humans edit it in place, and pages nest inside pages to any depth. There is no separate block format to learn and nothing to export: the thing the agent renders is the thing you review and the thing you share.

Next steps

The fastest way to understand Post Notion is to close one loop yourself.

NextInstall