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 page and publishes it with a title. Coldtea uploads the page and hands back a shareable URL of the form www.coldtea.ai/a/<id>. Anyone with the link can open it in a browser.

A single page can be up to 3 MB. An agent can republish to the same URL rather than minting a new one, so you can ask for a correction and keep the link you already shared.

You do not publish these yourself. You ask the agent for one. 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 you published there, newest first, with each entry's title, public URL, and when it was created. The listing covers only your own artifacts, and an agent can narrow it to a date range.

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.