Notes and diagrams for Claude Code

Let Claude Code write your notes and draw your diagrams.

Q: Does it work with Codex and other agents?

Yes. octonote setup codex writes AGENTS.md, and any tool that can run a shell command can use the CLI; output is JSON when piped.

Ask your agent to document a decision, draw the flow and publish it. The octonote CLI turns its markdown into notes and its Mermaid into real, editable canvases.

Get started free

Claude Code — octonote

> Document our auth flow with a diagram and publish it in my Architecture notebook

⏺ Bash(octonote guide)

⏺ Write(auth.md) · 42 lines

⏺ Write(auth.mmd) · flowchart LR

⏺ Bash(octonote project create "Auth flow" --note auth.md --canvas-mermaid auth.mmd --notebook Architecture --publish)

{ "id": "prj_8f2k…", "kind": "project",
  "notebook": "Architecture",
  "publicUrl": "https://octonote.ai/pub/auth-flow-x7q2" }

⏺ Done — “Auth flow” is in Architecture and published at octonote.ai/pub/auth-flow-x7q2

Architecture / Auth flow Published

Auth flow

The app sends an email code; Supabase verifies it and returns a session the API trusts.

How it works

Install and sign in

Install the octonote CLI and run octonote login once per computer. Cloud agents and CI use a token from Settings instead.

Teach your agent

octonote setup claude --skill adds Octonote to CLAUDE.md and installs a skill; octonote setup codex does the same for Codex.

Just ask

"Write up the auth flow in my Architecture notebook, with a diagram, and publish it." Agents only publish, share or delete when you ask.

Real examples

Project · DevOpsWhat happens when you run kubectl applyOpen page Canvas · DevOpsCI/CD pipeline with a safe rolloutOpen page Note · GitA git branching workflow that scalesOpen page

Questions

What can the agent do?

Create and edit notes from markdown, draw canvases from Mermaid flowcharts, create projects and notebooks, search, move, publish and share — with your account's permissions.

Does it work with Codex and other agents?

Yes. octonote setup codex writes AGENTS.md, and any tool that can run a shell command can use the CLI; output is JSON when piped.

Is it safe?

The agent acts as you, through the same permission checks as the app. It can't create tokens or delete your account, and delete needs an explicit --yes.

More: Notes with math and Mermaid · Technical explainers · Publish notes as a website · System design notes · Use with Claude Code and Codex

Start your first one free.

Free to start. No credit card, no password.

Get started free