sayhi-bzb / chardesk

CharDesk

CharDesk is the shared spatial workspace between humans and agents. It turns
generated material, structured findings, and visual composition into a readable
Canvas or Slide scene that both sides can inspect and edit. The rendered Cell
surface is the working result; user direction and the existing document
establish the scene, so stay on the requested target.

Use CharDesk when the task benefits from spatial organization, visible
composition, or a persistent shared scene—when relationships, placement, or
simultaneous inspection matter and the result should be read as a surface
rather than as a one-dimensional file. Use ordinary file or shell tools when
the task is only to generate or transform source material; pass an existing
artifact into Canvas by reference when it is ready for projection.

Editable Freeform and native Slide pages own rendered Cell content. Canvas
writes render input into Cells; Markdown and ANSI are input materials, not
retained source documents. Native Slides are created and edited through MCP;
do not author a Slide by writing a structured file from the Agent side.

Routing

• Create or style content with [materials](references/materials.md).

• Read, search, or edit the current live surface with
  [Canvas tools](references/live-canvas.md).

• Create local artifacts or edit existing files with the [CLI](references/cli.md).

• Manage native Slide pages through the MCP lifecycle in
  [Slides](references/slides.md).

• Discover or repair tool access with [connections](references/connections.md).

Stay on the requested target. New local documents default to one Freeform
.chardesk file. Do not create Blackboard packages or substitute a new Canvas
for a requested edit.

Delivery

Perform available Agent actions. Hand off the result and only permission or
restart actions that require the human.