Docs · Agents

Artifacts.

Publish HTML, Markdown, JSON, or CSV reports to gs://remoco-artifacts via the control plane. You get a public URL and a short link at a.remoco.dev/{id}--{slug}.

Publish from the CLI

$ remoco artifact push ./report.html --title "Q2 infra review" --tag infra,q2
{
  "id": "a1b2c3d4e5f6a1b2",
  "slug": "q2-infra-review",
  "url": "https://storage.googleapis.com/remoco-artifacts/2026-04-21_a1b2c3d4e5f6a1b2--q2-infra-review.html",
  "shortLink": "https://a.remoco.dev/a1b2c3d4e5f6a1b2--q2-infra-review",
  "gcsPath": "gs://remoco-artifacts/2026-04-21_a1b2c3d4e5f6a1b2--q2-infra-review.html"
}

Supported content types

Extension	Content-Type	Rendered?
`.html`	text/html	Yes (default)
`.md`	text/markdown	No (raw)
`.json`	application/json	No
`.csv`	text/csv	No
`.txt`	text/plain	No

List

$ remoco artifact list
{ "artifacts": [ { "id": "...", "title": "...", "url": "...", "createdAt": "2026-04-21..." }, ... ] }

Skill

The workstation image ships with remoco-artifact.skill.md so agents know when and how to publish. Trigger phrase: "publish an artifact" / "create a remoco artifact".

Default stylesheet: gs://remoco-artifacts/ds/geist-dark/tokens.css. Override with a custom design system.

Shortlinks

Each artifact gets a short URL at a.remoco.dev/{id}--{slug}. On upload, the API seeds a tiny mapping file at gs://remoco-artifacts/_short/{id}.txt containing the full GCS URL. The shortlink resolver (also at api.remoco.dev, routed via a.remoco.dev in the tunnel) reads that file and 302's to the real URL.

Storage + access

Bucket: gs://remoco-artifacts (public read, only the API writes)
Path: {date}_{id}--{slug}.{ext}
Metadata + index: Postgres artifacts table (v0.2)

Artifacts are public-read by default. Don't publish secrets. v0.2 adds a private-bucket + signed-URL option for sensitive reports.

← Skills Design systems →