omp packages

pi-artifacts0.1.0

Pi extension for generating, previewing, validating, and publishing self-contained artifacts.

gerardclos Published 4 months ago ~160 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

pi-artifacts

Pi package for creating, validating, previewing, and publishing self-contained artifacts.

Features

  • artifact_create scaffolds a single-page artifact in .pi/artifacts/<id>/.
  • artifact_validate enforces self-contained runtime and Cloudflare temporary Workers limits.
  • artifact_preview serves a local preview.
  • artifact_publish publishes through Cloudflare Workers Static Assets using wrangler deploy --temporary by default.
  • artifact_import_url imports an existing public artifact/page for update and republish workflows.
  • /artifact gallery provides a simple TUI picker.
  • Bundled Pi Artifact UI is grounded in Vercel Geist (https://vercel.com/design.md).
  • Optional Markdown-only design overrides: project .pi/artifacts/DESIGN.md, then user ~/.pi/agent/artifacts/DESIGN.md.

Custom artifact design systems

Drop a Markdown file in either location:

.pi/artifacts/DESIGN.md              # project-specific, highest priority
~/.pi/agent/artifacts/DESIGN.md      # user default for all projects

First file found wins. No config is required. Example:

# Acme Artifact Design System

- Primary color: #635bff
- Cards use 14px radius and soft lavender borders
- Buttons are pill-shaped
- Dashboards are compact with metric cards first
- Avoid gradients

When an artifact is created or edited, pi-artifacts injects the active design Markdown into the artifact guidance and records its fingerprint in artifact.json.

Publishing

Default publishing target is cloudflare-temporary.

Temporary publishing deliberately runs Wrangler with an isolated temporary home directory and without Cloudflare API environment variables, so it creates a no-signup temporary preview account even if the host machine is already authenticated with Cloudflare. Temporary deployments expire after 60 minutes unless claimed.

Permanent publishing is still available explicitly with target: "cloudflare-permanent".

Temporary Cloudflare limits are validated before publish: at most 1,000 files and 5 MiB per asset.

Install locally

pi install ./path/to/pi-artifacts

Or test for one session:

pi -e ./path/to/pi-artifacts