Artifacts

An agent can publish an HTML page it wrote as a Coldtea artifact and get back a public URL. Use this when an agent produces something you want to look at in a browser or send to a teammate: a report, a small dashboard, a rendered summary.

How an agent publishes one

The agent writes an HTML file, then calls the artifact_create tool with a title and either the file path or the HTML itself. Coldtea uploads the page and returns a shareable URL of the form www.coldtea.ai/a/<id>. Anyone with the link can open the page in a browser.

A single page can be up to 3 MB. To update a page in place, the agent passes the artifactId from the earlier call, and Coldtea republishes at the same URL instead of minting a new one.

You do not run this yourself. You ask the agent to produce the artifact, and the agent calls the tool. For example:

Write a single-page HTML summary of the test run and publish it as a Coldtea artifact titled "Checkout run 2026-08-03".

Where artifacts live

The published page is a web page, not a pane inside the desktop app. Open the returned www.coldtea.ai/a/<id> URL in a browser to view it, and share that link with anyone who should see it.

The per-TeaHouse listing

Artifacts belong to a TeaHouse. An agent can list what it published in a TeaHouse with the artifact_list tool, newest first. Each entry returns the artifact id, title, public URL, and creation time. The listing returns only artifacts you published, and an agent can narrow it by a date range or cap the count (20 by default).

Ask an agent to list them when you want to find a URL again:

List my recent Coldtea artifacts in this TeaHouse and give me the titles and URLs.

For the tool definitions, see MCP and local API.