Skip to content

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

docs: embed interactive Supademo demos in capability pages (#119)

shubhamagarwal-create873dae861f28
diff --git a/docs/mcp-servers.mdx b/docs/mcp-servers.mdx
index 851cd732a..c0552592e 100644
--- a/docs/mcp-servers.mdx
+++ b/docs/mcp-servers.mdx
@@ -30,6 +30,17 @@ An MCP server is configured with a small manifest:
Register it with `PUT /api/v1/settings/mcp-servers` (or through the UI). A catalog of popular servers is available at `GET /api/v1/settings/mcp-servers/catalog`, and you can verify connectivity with `GET /api/v1/settings/mcp-servers/{name}/tools`, which lists the server's live tools.
+<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.75", padding: "40px 0" }}>
+ <iframe
+ src="https://app.supademo.com/embed/cmsk7ca2801l91t0jwyiwj78i?embed_v=2&utm_source=embed"
+ loading="lazy"
+ title="Register a remote MCP server in TrueForge"
+ allow="clipboard-write"
+ allowFullScreen
+ style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
+ />
+</div>
+
### Authentication options
- **No auth** — public or network-trusted servers.
diff --git a/docs/models.mdx b/docs/models.mdx
index 475403c6b..6f1d68970 100644
--- a/docs/models.mdx
+++ b/docs/models.mdx
@@ -26,7 +26,7 @@ The shipped catalog (`GET /api/v1/settings/model-providers/catalog`) contains re
<Tabs>
<Tab title="UI">
- Open **Settings → Model Providers**, pick a provider from the catalog, and paste your API key. Models from that provider become available immediately in the model selector.
+ Open **Settings → Models**, pick a provider from the catalog, and paste your API key. Models from that provider become available immediately in the model selector.
</Tab>
<Tab title="API">
Fetch a template from the catalog, fill in the credentials, and upsert it:
@@ -43,6 +43,17 @@ The shipped catalog (`GET /api/v1/settings/model-providers/catalog`) contains re
</Tab>
</Tabs>
+<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.75", padding: "40px 0" }}>
+ <iframe
+ src="https://app.supademo.com/embed/cmsk7202v01l51t0jkq022fjk?embed_v=2&utm_source=embed"
+ loading="lazy"
+ title="Configure a model provider in TrueForge"
+ allow="clipboard-write"
+ allowFullScreen
+ style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
+ />
+</div>
+
## Referencing a model in an agent
Models are addressed as `provider/model` in the agent spec:
diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
index 79977b122..e1f2e0150 100644
--- a/docs/quickstart.mdx
+++ b/docs/quickstart.mdx
@@ -70,7 +70,7 @@ description: 'Run TrueForge with one command, configure a model provider, and ha
TrueForge ships with a catalog of model providers. Configure one before your first chat:
<Steps>
- <Step title="Open Settings">In the UI, open **Settings → Model Providers**.</Step>
+ <Step title="Open Settings">In the UI, open **Settings → Models**.</Step>
<Step title="Pick a provider">
Choose a provider from the catalog — OpenAI, Anthropic, Google Gemini, or an OpenAI-compatible endpoint — and paste
your API key.
@@ -82,6 +82,17 @@ TrueForge ships with a catalog of model providers. Configure one before your fir
Everything you can do in Settings is also available through the API — see `GET /api/v1/settings/model-providers/catalog` and `PUT /api/v1/settings/model-providers` in the interactive API docs at `/api/v1/docs`.
+<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.75", padding: "40px 0" }}>
+ <iframe
+ src="https://app.supademo.com/embed/cmsk7202v01l51t0jkq022fjk?embed_v=2&utm_source=embed"
+ loading="lazy"
+ title="Configure a model provider in TrueForge"
+ allow="clipboard-write"
+ allowFullScreen
+ style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
+ />
+</div>
+
## Start chatting
Send your first message. Out of the box the agent supports multi-turn conversations with streaming. To give it more capabilities:
@@ -90,6 +101,17 @@ Send your first message. Out of the box the agent supports multi-turn conversati
- **Enable the sandbox** — configure a [sandbox provider](/sandbox) so the agent can run code and use [skills](/skills).
- **Add skills** — register [git-backed skills](/skills) under **Settings → Skills**.
+<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.46", padding: "40px 0" }}>
+ <iframe
+ src="https://app.supademo.com/embed/cmsk13xio00k81p0j1wj6amj6?embed_v=2&utm_source=embed"
+ loading="lazy"
+ title="Chat with an agent in TrueForge"
+ allow="clipboard-write"
+ allowFullScreen
+ style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
+ />
+</div>
+
## Call the API
Every conversation in the UI is a session in the API. Create one yourself:
diff --git a/docs/sandbox.mdx b/docs/sandbox.mdx
index 130a7e615..496a417b3 100644
--- a/docs/sandbox.mdx
+++ b/docs/sandbox.mdx
@@ -55,6 +55,17 @@ TrueForge delegates sandbox compute to a provider. Configure it once — in the
A template with defaults is available at `GET /api/v1/settings/sandbox-providers/catalog`. Whether a provider is configured is reported by `GET /api/v1/capabilities`.
+<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.75", padding: "40px 0" }}>
+ <iframe
+ src="https://app.supademo.com/embed/cmsk7vatl00pz0n0jme1d96w5?embed_v=2&utm_source=embed"
+ loading="lazy"
+ title="Configure a sandbox provider in TrueForge"
+ allow="clipboard-write"
+ allowFullScreen
+ style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
+ />
+</div>
+
## Enabling the sandbox on an agent
The sandbox is **off by default** per agent. Enable it in the agent spec:
diff --git a/docs/skills.mdx b/docs/skills.mdx
index 171f5e0c6..873d3ea66 100644
--- a/docs/skills.mdx
+++ b/docs/skills.mdx
@@ -54,6 +54,17 @@ Register it with `PUT /api/v1/settings/skills` (or through the UI). Starter skil
tag or SHA, test changes on a branch, and roll back by changing the ref.
</Tip>
+<div style={{ position: "relative", boxSizing: "content-box", width: "100%", aspectRatio: "1.75", padding: "40px 0" }}>
+ <iframe
+ src="https://app.supademo.com/embed/cmsk7of5d00eezq0jjcap0qxp?embed_v=2&utm_source=embed"
+ loading="lazy"
+ title="Register a skill in TrueForge"
+ allow="clipboard-write"
+ allowFullScreen
+ style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
+ />
+</div>
+
## Attaching skills to an agent
Agents reference skills by name only: