Skip to content

Agent docs

Claude Code writes markdown files outside your worktree. The agent docs pane shows them for the Claude Code session in a tab, rendered:

  • Plans: the plans the session wrote in plan mode.
  • Memory: the auto memory of the session’s project, with MEMORY.md and a file for each memory.
  • Claude scratchpad: the notes and reports the session wrote in its scratchpad folder. This is Claude Code’s own scratchpad, not mocante’s scratchpad.
  • Background job: the reports of a claude --bg job or a workflow that this session ran as.
  • Your CLAUDE.md: your own instructions in ~/.claude/CLAUDE.md.

The pane only reads. The agent writes these files.

Click the agent docs button at the top right of a session. It shows only when a tab of the session runs Claude Code. The pane opens over the other panes. Pin it to keep it beside them, as with any pane.

The pane opens on the newest plan, or on the newest file when the session has no plan.

The list at the left groups the files, the newest first. Click a group’s name to fold it, and again to unfold it. The list button at the top left hides the list, so a document gets the whole pane. The pane remembers both choices on this device.

Click a file to open it in a tab. Like the scratchpad, the pane keeps the documents you open as tabs at the top:

  • Click a tab to show its document. Its icon says which kind of file it is.
  • Drag a tab to put it somewhere else in the row.
  • Click the × on a tab, or middle-click it, to close it. Closing a tab does not touch the file.
  • While the pane has the keyboard, the tab shortcuts switch its tabs, ⌘W closes the tab you see, and ⌘T picks a document to open. ⌘W on the last tab hides the pane, as in the scratchpad.
  • A tab whose file is gone is struck through.

The tabs belong to the Claude Code session of the tab on screen. When the terminal shows another Claude tab, the pane shows that conversation’s files and tabs, and switching back brings the first one’s tabs back. The tabs are the same in a pop-out window and in the main window.

  • Rendered shows the markdown, and Source shows the text.
  • A memory file shows its name, description and type above its text. A [[name]] link opens that memory.
  • A link to another file in the same folder opens it in a tab. Web links open in your browser, and a #heading link scrolls to its heading.
  • The copy button copies the file’s path on the host.

The pane reads a file again when it changes, so you can watch a plan while Claude writes it.

From the command palette:

  • Show agent docs opens or hides the pane.
  • Show Claude’s plan opens the newest plan.
  • Open a Claude document… lists every file to pick one.
  • Show the list of agent docs, Show the agent doc’s source and Close the agent doc’s tab work while the pane is open.

When Claude asks to leave plan mode and the request shows in mocante, the request names the plan’s title. View plan opens the plan in the pane.

A markdown file path in the terminal is a link. Hold ⌘ (Ctrl on Linux) and click it:

  • A file in the session’s worktree opens in a code tab, rendered. A relative path is read from the worktree first.
  • A plan, memory, scratchpad or job file of the session opens in the agent docs pane. A relative path, such as memory/notes.md, finds the file whose path ends with it.

mocante opens no other file this way. A path that names no such file shows a notice instead.

On a remote host, the mocante agent on the host reads the files. A host whose agent is older says that it needs a newer agent, which it gets when it reconnects.