Read and edit docs beside the agent writing them

Your agent can open a doc for you. crystl markdown show docs/spec.md puts that file in the side panel, rendered. An agent about to touch the renderer can pull up the architecture spec beside its own terminal, and you both read the same page. Just ask: "show me the spec you're working from."

Fenced mermaid blocks draw as diagrams: flowcharts, sequence diagrams, state machines, Gantt charts. Ask an agent to map how a request moves through your app, and the picture opens next to the terminal. The libraries ship inside crystl, so diagrams render offline and the file never leaves your machine. If a diagram has a syntax error, that one block shows the error and the rest of the page still renders.

You can drive it yourself too. The editor is one of the slide-out panel's views, next to the workbench and the files drawer, and Cmd+] cycles between them. Pick any .md in the project, read it rendered, press edit to change the source, and save. Switching between view and edit keeps your draft and your undo history. The edit side is plain monospace text with no formatting toolbar, so it suits people who already write markdown. Remote images wait behind a load button, so previewing a stranger's README doesn't tell their image host you opened it. The markdown and Mermaid docs cover the details.