Agents

Use the coding agent you already have. Schematlas gives it documentation tools and reviews every change.

Supported agents

AgentConnection
Claude CodeIts native stream-json protocol
Codexcodex app-server
Gemini CLI, OpenCodeTheir built-in ACP mode
Any ACP agentCustom agent…, with its command and arguments

Agents run in the project folder with their own login, model and settings. Schematlas finds installed agents without launching them.

Modes

Choose the agent's own permission mode in the composer — for Claude Code Ask first, Accept edits, Plan and the others; for Codex Read only, Auto or Full access. Modes govern the agent's own tools, like editing source files or running commands. They never skip Schematlas reviews.

What the agent knows

The file you have open is sent with your message as one line of context:

text
Open in Schematlas: diagram `.schematlas/diagrams/checkout.mmd`, selected node `api` (“Orders API”).

It shows as a chip in the composer; dismiss it to send the message without it.

Tools

Schematlas gives the agent a project-scoped set of tools. Tools that change files or touch a database wait for your approval.

ToolDoesReview
repo_outlineSummarize the repository: languages, entry points, folders
list_diagramsList diagrams and docs
get_diagram, read_diagram_sourceRead a diagram
write_diagramCreate or replace a Mermaid diagramYes
edit_diagramAdd or remove nodes and edges, relabel, annotateYes
read_doc, write_docRead or write a wiki pageWrite
read_toc, write_tocRead or reorganize the table of contentsWrite
check_refsFind code references that no longer resolve
list_sources, search_schema, describe_table, get_schema, find_join_pathExplore connected schemas
table_stats, sample_rows, explain_sql, query_sqlQuery a databaseYes
request_httpCall a documented API operationYes
get_canvas, move_nodes, create_group, remove_groupArrange a schema canvas

Proposals are validated before you see them: a diagram must parse, a page's citations must resolve. The review shows the change — nodes added, changed and removed, or a Markdown diff — and the file is written only if you allow it and it has not changed in the meantime.

Generating the wiki

Generate the wiki asks the agent to survey the repository with repo_outline, propose a structure in toc.yaml and wait for your approval, then write the pages and their diagrams with code references.

Conversations

Conversations belong to the agent. Schematlas keeps only their ids, lists them in the project home, and reopens them with the agent's own resume — Claude's --resume, Codex's thread/resume, ACP's session/load. The transcript is never copied.

Edit this page