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.mdxindex 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.mdxindex 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 agentModels are addressed as `provider/model` in the agent spec:diff --git a/docs/quickstart.mdx b/docs/quickstart.mdxindex 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 haTrueForge 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 pasteyour API key.@@ -82,6 +82,17 @@ TrueForge ships with a catalog of model providers. Configure one before your firEverything 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 chattingSend 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 APIEvery conversation in the UI is a session in the API. Create one yourself:diff --git a/docs/sandbox.mdx b/docs/sandbox.mdxindex 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 theA 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 agentThe sandbox is **off by default** per agent. Enable it in the agent spec:diff --git a/docs/skills.mdx b/docs/skills.mdxindex 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 skiltag 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 agentAgents reference skills by name only: