Artifacts and Checkpoints

Artifacts are files (Markdown, JSON, CSV, images, ...) that an agent publishes during a session via session.artifacts.publish(path, options?). Checkpoints are explicit named save points.

fh artifacts

fabric-harness artifacts <session-id> [--json]

List artifacts for a session. The default output shows id, name, content type, byte size, and creation time.

fh artifact get

fabric-harness artifact get <session-id> <artifact-id-or-name> [--out <path>]

Fetch a single artifact. If --out is omitted, the artifact prints to stdout (use redirection for binary content). If both an id and a name match, the id wins.

fh artifact get ask-1f4f... report.md --out ./reports/report.md

fh checkpoints

fabric-harness checkpoints <session-id>

List checkpoints for a session. Each entry includes label, created time, and (when available) a sandbox snapshot reference.

See also

• Building agents → Artifacts
• Artifacts and observability