Guide
Contributor-facing walkthroughs for surfaces that own a contract not fully covered elsewhere in doc/ — MCP/agent tooling, provider/frontmatter contracts, and the ROOT/LEAF generator flow. For end-user feature documentation, see the Japanese manual at manual.zudo-text.app.
ROOT app — generating leaf text apps — how to use
zudotext.app(ROOT) to generate LEAF text apps via the no-compile copy-based pipeline.Cloud-first onboarding (web editor) — getting started in the browser-based editor against the cloud backend.
Inline AI command — the
@@/ Cmd+J prompt surface inside the editor, and how to choose between baked ghost text and the mini panel.Inline AI command — skill authoring — how to write your own
/skill files and where they live.skill- name MCP integration (Claude Code and Codex) — install the package and official skills, choose the appropriate credential, and use the 21-tool authoring profile or the separate eight-tool restricted Kanban profile that requires this build until a separate package release.
Agent task recipes (MCP) — the same surface organized by task: the sentence to type at Claude Code or Codex, the tool sequence it triggers, and the one caveat that matters per job.
Media uploader — drag, paste, Insert asset…, or shortcut any file (not just images) into the editor; how cloud R2 storage differs from the local desktop path.
Edit key bar — shared editing keys, the four desktop placements and their grouped menu, the compact mobile palette and move mode, settings shape, and the key catalog contract.
Frame Components Reference — every view provider you can load into a leaf, what each one shows, and how the layout switcher behaves.
Header pins — the toolbar shortcut icons, how to create/edit/reorder them, and the temp-pin draft-mode mechanics.
Toolbar customization — the
AppSettings.toolbarsmodel, the surface registry, the right-click customize menu, and how to make a new toolbar's buttons hideable.Note order, insertion and Sweep Empty — the shared ghost-reorder gesture, Manual sort, insert-at-position placement, the pending-number slot, and the reviewed Sweep Empty batch delete.
Paste as Plain Text — the
Mod+Shift+Vplain-text paste command: entry points, the ownership fence, and which clipboard formats each adapter can read.Spotlight file/directory picker — the keyboard-driven path picker that replaces the native macOS folder dialog, and how to disable it.
Auto-managed frontmatter fields — the built-in
created_at/updated_atand other fields the app maintains for you.Frontmatter schema — how the per-workspace schema defines and validates note/archive metadata.
Personal Access Tokens — least-privilege document/asset defaults, optional agent access, explicit Full compatibility, workspace binding, and revocation.