Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

docs: refresh screenshots — chat UI, custom provider, MCP, Agent Library (#264)

shubhamagarwal-create8946f9b0ccbb
diff --git a/docs/chat-ui.mdx b/docs/chat-ui.mdx
index 66762bddb..cfd17a976 100644
--- a/docs/chat-ui.mdx
+++ b/docs/chat-ui.mdx
@@ -24,8 +24,8 @@ When you run TrueForge ([Quickstart](/quickstart)), open the app URL (for exampl
- Settings for [models](/models), [connectors](/mcp-servers), [skills](/skills), and [sandbox](/sandbox)
- [Generative UI](/create-agent/generative-ui) rendering out of the box
-<Frame caption="The bundled chat UI — streaming responses and agent steps.">
- <img src="/images/getting-started-chat.png" alt="TrueForge chat UI with agent response and tool calls" />
+<Frame caption="The bundled chat UI — a streaming response with an expanded agent-steps panel: reasoning, tool calls, and a subagent.">
+ <img src="/images/chat-ui.png" alt="TrueForge chat UI with an agent response and an expanded agent-steps panel including a subagent" />
</Frame>
## What you can customize
diff --git a/docs/images/add-custom-model-provider.png b/docs/images/add-custom-model-provider.png
index 906dbb420..a1f5fa50f 100644
Binary files a/docs/images/add-custom-model-provider.png and b/docs/images/add-custom-model-provider.png differ
diff --git a/docs/images/agents-library.png b/docs/images/agents-library.png
index 14575cd3b..be33b11aa 100644
Binary files a/docs/images/agents-library.png and b/docs/images/agents-library.png differ
diff --git a/docs/images/chat-ui.png b/docs/images/chat-ui.png
new file mode 100644
index 000000000..b0c7ba7ba
Binary files /dev/null and b/docs/images/chat-ui.png differ
diff --git a/docs/images/getting-started-chat.png b/docs/images/getting-started-chat.png
deleted file mode 100644
index 45791a3f8..000000000
Binary files a/docs/images/getting-started-chat.png and /dev/null differ
diff --git a/docs/images/mcp-connectors.png b/docs/images/mcp-connectors.png
new file mode 100644
index 000000000..8abd5378d
Binary files /dev/null and b/docs/images/mcp-connectors.png differ
diff --git a/docs/images/mcp-in-chat-auth.png b/docs/images/mcp-in-chat-auth.png
new file mode 100644
index 000000000..3773becdc
Binary files /dev/null and b/docs/images/mcp-in-chat-auth.png differ
diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index a67f28758..cf21e0494 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -19,8 +19,8 @@ An agent harness is the runtime layer around an LLM that turns it into a reliabl
TrueForge is an **open-source agent harness** with three parts: a **core server** that runs the agent loop, an **HTTP API** (with a TypeScript SDK) to drive it from code, and a **chat UI** (with a React UI SDK) to drive it from the browser.
-<Frame caption="The bundled chat UI — streaming responses, an expandable agent-steps panel, and tool calls.">
- <img src="/images/getting-started-chat.png" alt="The TrueForge chat UI showing an agent response with an agent-steps panel and tool calls" />
+<Frame caption="The bundled chat UI — a streaming response with the agent-steps panel expanded to show reasoning, tool calls, and a subagent.">
+ <img src="/images/chat-ui.png" alt="The TrueForge chat UI showing an agent response with the agent-steps panel expanded — reasoning, Exa tool calls, and a subagent" />
</Frame>
### Key Components
diff --git a/docs/mcp-servers.mdx b/docs/mcp-servers.mdx
index 98d811691..cc69afa3f 100644
--- a/docs/mcp-servers.mdx
+++ b/docs/mcp-servers.mdx
@@ -12,6 +12,10 @@ Register them once under **Settings → Connectors**. Agents attach servers by n
Open **Settings → Connectors**, pick a server from the catalog, complete auth if required, and save. The server is then available when you [create an agent](/create-agent/overview).
+<Frame caption="Settings → Connectors — connect a server from the catalog (each shows its auth type).">
+ <img src="/images/mcp-connectors.png" alt="The Settings → Connectors page showing a connected server above a catalog of MCP servers labelled by auth type" />
+</Frame>
+
You can also use **Add MCP Server** to register any remote URL that is not in the catalog.
<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.75", padding: "40px 0" }}>
@@ -46,23 +50,8 @@ The catalog entries under **Settings → Connectors** (Linear, Notion, GitHub, a
If a server uses OAuth and the user has not yet authorized it, the turn pauses and the chat UI shows a **Connect** button. The user completes OAuth in a popup and continues the conversation — the agent does not fail.
-{/* TODO: Add screenshot of in-chat MCP OAuth Connect button. */}
-<Frame caption="TODO: Screenshot — in-chat MCP authentication showing the Connect button when OAuth is required.">
- <div
- style={{
- display: "flex",
- alignItems: "center",
- justifyContent: "center",
- minHeight: 200,
- border: "1px dashed #94a3b8",
- borderRadius: 8,
- color: "#64748b",
- padding: 24,
- textAlign: "center",
- }}
- >
- TODO: Screenshot of in-chat MCP auth (Connect button in chat)
- </div>
+<Frame caption="In-chat MCP authentication — the turn pauses with a Connect button until the user authorizes the server, then continues.">
+ <img src="/images/mcp-in-chat-auth.png" alt="The chat UI showing an MCP Authentication Required panel for the Notion server, with Connect and Continue buttons" />
</Frame>
## Next steps
diff --git a/docs/models.mdx b/docs/models.mdx
index 2eb07aa49..a5a9fa01d 100644
--- a/docs/models.mdx
+++ b/docs/models.mdx
@@ -41,8 +41,8 @@ The provider list comes from the shipped model catalog — see [Initial Setup](/
Use the `custom` provider type for vLLM, Ollama, a corporate gateway, or any other OpenAI-compatible API. Custom providers are not in the catalog — you add them yourself with a base URL, API key, and the model IDs you want exposed.
-<Frame caption="Adding a custom OpenAI-compatible provider (vLLM, Ollama, a gateway) with base URL, API key, and model IDs.">
- <img src="/images/add-custom-model-provider.png" alt="The Add Custom Provider dialog with name, base URL, API key, and model fields" />
+<Frame caption="The Add custom provider dialog — connect any OpenAI-compatible endpoint with a base URL, an optional API key, and one or more models (each with its context length and max output tokens).">
+ <img src="/images/add-custom-model-provider.png" alt="The Add custom provider dialog filled for a Groq endpoint — name, base URL, an optional API key, a model with its ID and name, and Advanced context length and max output tokens" />
</Frame>
<Note>