OCC Artifact Gallery
Use when an agent generates local files/folders and must return mobile-accessible OCC/Tailscale viewer links instead of filesystem paths.
Artifact Gallery
Overview
OCC Artifact Gallery turns generated local outputs on a VPS/headless server into stable HTTPS links that users can open from Telegram, WhatsApp, Discord, or a browser.
Use this for images, PDFs, HTML, Markdown, JSON, audio, video, reports, screenshots, and generated folders. Do not give users only /home/... paths when they are on mobile.
Canonical URLs
- Gallery UI:
https://n2-pro.tail1c2e65.ts.net/artifacts - Artifact viewer:
https://n2-pro.tail1c2e65.ts.net/artifacts/a/{artifact_id} - API:
http://127.0.0.1:8080/api/artifacts-gallery
CLI
Register a generated file:
/home/shadoprizm/occ/venv/bin/python /home/shadoprizm/occ/scripts/artifact_gallery_tool.py register \
--path /home/shadoprizm/occ/brain/infographic-studio/active/INFOG-6311545c/infographic-v1.png \
--title "OCC Infographic dogfood output" \
--source-system occ \
--source-agent concierge \
--tags infographic dogfood
List recent artifacts:
/home/shadoprizm/occ/venv/bin/python /home/shadoprizm/occ/scripts/artifact_gallery_tool.py list --limit 20
Get links:
/home/shadoprizm/occ/venv/bin/python /home/shadoprizm/occ/scripts/artifact_gallery_tool.py links art_xxxxx
Agent response contract
When replying over mobile/chat channels, include:
- brief summary
viewer_url- optional
download_url - artifact type/size
Example:
Done — generated the report.
View:
https://n2-pro.tail1c2e65.ts.net/artifacts/a/art_xxxxx
Download:
https://n2-pro.tail1c2e65.ts.net/api/artifacts-gallery/art_xxxxx/download
Safety
The gallery only serves allowlisted roots and refuses credential/dot/secret-like paths. If registration fails, do not bypass it by inventing a URL; fix the path/root or report the failure.
Related skills
- Downloads
- 792All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v0.1.0
- License
- MIT-0
