A lightweight Python CLI for repeatable creator workflows. Generate content ideas and tags, or normalize a folder of image names from an interactive menu or scriptable subcommands.
This seven-second loop uses real CLI output, disposable sample files, and a fixed seed for reproducible suggestions.
- Preview filename changes before touching a directory, then undo applied renames from a manifest.
- Automate every scriptable workflow with stable JSON schemas and meaningful exit codes.
- Get the same CLI behavior on current Windows, macOS, and Linux systems.
- Keep small creator tasks local, inspectable, and easy to compose in scripts.
| Goal | Before | Example result |
|---|---|---|
| Draft a title | creator workflow |
10 Creator Workflow Tips Every Beginner Should Know |
| Pick three tags | --count 3 |
automation, productivity, tutorial |
| Preview image renames | --prefix campaign |
campaign_1.jpg, campaign_2.png — no files changed |
See the demo transcript and reproduction steps.
- Generate title ideas from a keyword.
- Select unique tags from a curated list.
- Preview, apply, and undo deterministic JPEG and PNG filename changes with a safe custom prefix.
- Use automation-friendly subcommands or an interactive menu.
- Python 3.11+
- A current Windows, macOS, or Linux system
See the platform support policy for the tested OS/Python matrix and support expectations.
Install the latest stable release from PyPI:
python -m pip install creator-toolkit-cliRelease notes and verified distribution hashes are available in the latest GitHub release.
Generate a title or tags:
creator-toolkit title "video editing"
creator-toolkit tags --count 5Pass the same integer seed to reproduce a title or tag set; omit it for fresh suggestions:
creator-toolkit title "video editing" --seed 2026
creator-toolkit tags --count 5 --seed 2026Add --json to any scriptable subcommand for automation-friendly output:
creator-toolkit title "video editing" --seed 2026 --json
creator-toolkit tags --count 5 --seed 2026 --json
creator-toolkit rename ./images --prefix campaign --dry-run --jsonSee the JSON output reference for response schemas, exit codes, error handling, and automation examples.
Preview changes to .jpg, .jpeg, and .png files without touching the directory:
creator-toolkit rename ./images --prefix campaign --dry-runThis produces names such as campaign_1.jpg. Omit --prefix to retain the default image_1.jpg
format. Unsafe filename components and cross-platform reserved names are rejected before any file
or manifest changes.
Apply the displayed plan after an interactive confirmation, using the same prefix:
creator-toolkit rename ./images --prefix campaignFor non-interactive automation, pass --yes. Every applied CLI rename writes a unique JSON
manifest in the image directory:
creator-toolkit rename ./images --prefix campaign --yes
creator-toolkit undo ./images/.creator-toolkit-renames-20260807T120000Z-a1b2c3d4.json --dry-run
creator-toolkit undo ./images/.creator-toolkit-renames-20260807T120000Z-a1b2c3d4.jsonThe rename command orders inputs by filename and uses a two-phase rename to avoid collisions and roll back when a filesystem step fails. Undo manifests store concrete operations, so undo does not need the original prefix. They reject path traversal and refuse to overwrite files created after the rename. Other files are left untouched, but a separate backup is still recommended for valuable assets.
Run without a subcommand to use the interactive menu:
creator-toolkitLooking for a first contribution? Browse open
good first issue
or help wanted
work, comment with your intended approach, and follow the
contributor guide.
Focused documentation, testing, bug-fix, and small feature pull requests are welcome.
python -m pip install -e ".[dev]"
ruff check .
ruff format --check .
pytestSee CONTRIBUTING.md for setup, validation, demo generation, and pull request expectations.
Maintainers should follow the release checklist and complete the one-time trusted publishing setup before publishing a version.
MIT © 2026 HoungDev contributors.