save-artifact

Save and organize target artifacts (documents, presentations, markdown, images, SVGs) to ~/projects/artifacts-viewer. Use when user wants to save or organize docs, PDFs, PPTs, markdown files, images (PNG, JPG, SVG), or any visual/document artifacts to a central viewer location. Also use to initialize git repo for artifacts-viewer and push to GitHub.

save-artifact

Save target artifacts to ~/projects/artifacts-viewer for easy viewing and organization.

Quick Usage

Ensure target directory exists: ~/projects/artifacts-viewer (auto-created if missing)
Save artifact: Copy or move the file to artifacts-viewer with appropriate naming
Git operations: Initialize git repo and push to GitHub when needed

Supported File Types

Documents: .pdf, .doc, .docx
Presentations: .ppt, .pptx
Markdown: .md, .mdx
Images: .png, .jpg, .jpeg, .gif, .svg
Other: .txt, .json

Workflow

Save Artifact

# Ensure directory exists
mkdir -p ~/projects/artifacts-viewer/artifacts/<category-subdir>

# Copy artifact to viewer subdirectory (use descriptive name)
cp <source-file> ~/projects/artifacts-viewer/artifacts/<category-subdir>/<descriptive-name>

# REQUIRED: Regenerate manifest so web viewer picks up new files immediately
python3 ~/projects/artifacts-viewer/artifacts/scan_manifest.py

Git Operations

cd ~/projects/artifacts-viewer
git init
git add .
git commit -m "Add artifacts"
git remote add origin https://github.com/<username>/artifacts-viewer.git
git push -u origin main

Script Usage

Use scripts/save_artifact.py for automated saving:

python3 scripts/save_artifact.py <source_path> [--name <custom_name>] [--category <category>]

Categories: docs, slides, markdown, images, diagrams, other

Notes

Always use descriptive, unique names for artifacts
Consider organizing by category subdirectories if needed
Commit and push to GitHub for version control and sharing