pi-artifacts

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

Packages

Package details

extensionskill

Install pi-artifacts from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-artifacts
Package
pi-artifacts
Version
0.1.0
Published
Jun 23, 2026
Downloads
207/mo · 30/wk
Author
gerardclos
License
unknown
Types
extension, skill
Size
49.7 KB
Dependencies
2 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./skills/artifact-designer"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

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