Skip to content

t236.4: Output organization + metadata — project dirs, descriptive filenames, JSON sidecars, dedup #965

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marcusquinn merged 3 commits into from
Feb 10, 2026
Merged

t236.4: Output organization + metadata — project dirs, descriptive filenames, JSON sidecars, dedup #965

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4b2f746
feat: add output organization core — project dirs, JSON sidecars, ded…
marcusquinn Feb 10, 2026
9d143a6
feat: update all download callers with project dirs, sidecars, dedup …
marcusquinn Feb 10, 2026
782ec6a
docs: add output organization docs, CLI help for project dirs/sidecar…
marcusquinn Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .agents/scripts/higgsfield-helper.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -267,6 +267,7 @@ Options (pass after command):
--headless Run without browser window (default)
--model, -m Model: soul, nano_banana, seedream, kling-2.6, etc.
--output, -o Output directory
--project Project name for organized output dirs ({output}/{project}/{type}/)
--image-file Image file for upload
--timeout Timeout in milliseconds
--effect App/effect slug
Expand All @@ -276,12 +277,15 @@ Options (pass after command):
--character-image Character face image for pipeline
--dialogue Dialogue text for lipsync
--unlimited Prefer unlimited models only
--no-sidecar Disable JSON sidecar metadata files
--no-dedup Disable SHA-256 duplicate detection

Examples:
higgsfield-helper.sh setup
higgsfield-helper.sh login
higgsfield-helper.sh image "A cyberpunk city at night, neon lights, rain"
higgsfield-helper.sh image "Portrait of a woman" --model nano_banana
higgsfield-helper.sh image "Portrait" --project my-video --output ~/Projects/
higgsfield-helper.sh video "Camera pans across mountain landscape"
higgsfield-helper.sh video "Person walks forward" --image-file photo.jpg
higgsfield-helper.sh lipsync "Hello world!" --image-file face.jpg
Expand Down
Loading