Pages and the block editor

Every page in Claos uses the same block editor — whether you wrote it or an agent produced it. There's no separate "AI doc" surface. An agent's draft opens with the same toolbar, behaves the same way, and lives in the same folder tree as a page you started from scratch.

This article walks the editor end to end: creating a page, the typing model, saving, real-time collaboration, and the shortcuts you'll use every day.

Three ways to create a page

From the sidebar. Hover the Knowledge Base header, click the +, and choose Page. It lands at the top of your tree, ready to rename.
From inside another page. Use the editor's + New sub-page action — the new page nests under the one you're in.
From an agent. When an agent runs with a page-creating tool, it writes a new page into a folder you'll find in the inbox notification.

You'll meet pages from all three paths over a typical week.

The editor

The editor is block-based and Notion-style. Type anywhere; what you type becomes a block. Press Enter to start a new block, Backspace at the start of a block to merge it with the previous one, Tab to indent inside lists and toggles.

Press / anywhere to open the slash menu and insert any block type — see Block types reference for the full list.

Saving

The editor saves as you type. There's no save button — if you see the editor responding to your typing, your changes are persisted. Close the tab whenever you like.

Markdown shortcuts

If you'd rather not reach for the slash menu, the editor recognizes common Markdown as you type:

# , ## , ### → Heading 1, 2, 3
- → bullet list
1. → numbered list
> → blockquote
triple backticks → code block

Typography auto-replacements work too — (c) becomes ©, straight quotes become curly.

Markdown only covers the basic blocks. Advanced blocks (toggle, callout, table), media (image, file, bookmark, embed), and the AI inline blocks are slash-menu only.

Real-time collaboration

When several people open the same page, you see each other's cursors and edits in real time, colour-coded per person. Presence avatars at the top show who's looking right now. Edits sync continuously — you don't need to refresh, and there's no merge conflict to resolve.

It works across tabs too: open the same page in two windows and you'll see your own cursor in one window from the other.

Three inline shortcuts to remember

The shortcuts that come up most often:

/ — slash menu. Insert any block type (headings, lists, callouts, tables, media, AI blocks).
@ — mention a teammate. They get a notification.
[[ — link to another page. You get a hyperlink and the linked page gains a backlink.

Together they cover most of what you'll reach for during editing.

The page header

Above the editor: the page's icon, its title, and a breadcrumb showing the folders above it. Click the icon to change it, click the title to rename. The breadcrumb is clickable too — handy for jumping up to a parent folder without going back to the sidebar.

The folder a page belongs to is set by the sidebar tree — drag the page in the sidebar to move it. Moving doesn't break links.

Reading what an agent wrote

When an agent runs and produces a page, the inbox surfaces a notification that links to it. Click through — the page opens like any other in the editor, complete with the agent's draft. From there it's yours: edit, expand, link, share. The agent's contribution becomes a starting point, not a final state.

If you want to see the full run behind the page — the tool calls, the steps, the conversation — click through to the agent's chat from the inbox item or the agent's detail page. See Reading agent runs.

Tips and gotchas

The same editor is also where agent edits land. When you ask an agent to extend or revise a page, the changes appear in the editor as if a teammate had typed them.
Mentioning is a notification action. @mention pings the person in their inbox; it doesn't pull them into the page automatically. They have to click through to read.
Backlinks update in real time. Add a [[link]] and the target page picks up the backlink the next time it's opened — useful for building wikis.
There's no draft / publish distinction. Every edit is live. Use version history to go back if needed.