| name | chardesk |
| description | Authoritative syntax and direct Blackboard workflow for canonical `.chardesk` documents, Canvas text, CharGraph structured sources, ESC-less ANSI, block layouts, and Slides. Use when Codex needs to create, edit, style, or review CharDesk content. |
CharDesk formats
Load only the required reference:
- Canvas text or ANSI styling:
references/ansi.md.
- Markdown, fenced Mermaid or data, and math:
references/chargraph.md.
- Multi-field or multi-row Canvas composition:
references/block-layout.md.
- Slide document structure:
references/slides.md.
- Headless source checking or artifact rendering:
references/rendering.md.
- Multi-file Blackboard packages:
references/blackboard.md.
- Styled Slides: Slides first, then ANSI.
- Slides that compile Markdown, Mermaid, data, math, or block layout: Slides
first, then CharGraph; load Block Layout when the source uses
||| or ---.
- Structured fields in a block layout: Block Layout first, then CharGraph; also
load ANSI only when the source uses explicit CharDesk styles.
For a single-file Blackboard, use the named .chardesk path or
blackboard.chardesk when none is named. For a package, read
blackboard.yaml first and open only the Panels required by the task:
- Read an existing Blackboard before writing.
- Patch locally with
apply_patch; clear or replace only when explicitly asked.
- For a new complex layout, write Plain first, then add sparse style controls
with a second patch to the same file. Unstyled cells use the default style.
- Run
npm exec -- chardesk-blackboard check <board.chardesk|blackboard.yaml|directory>.
- Report only what changed and where; do not repeat the Blackboard in chat.
The protocol owns ANSI, CJK, grapheme, and width logic. Use visible ESC-less
controls in .chardesk; never emit terminal ESC bytes or reproduce validation.
