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