| name | auto-skill-build-sources-inventory |
| description | Generate and refresh a metadata-only inventory of local `sources/` shallow clones (size, git remote, HEAD, commit date, license filename) and write it into `plugins/codex-supercharge/references/source-repos.md`. Use when you want a fast “what sources do we have?” view, to control disk growth, or before doing a source-pattern synthesis pass. Skip when there is no `sources/` directory or you are not working with local clones.
|
Sources Inventory (auto-generated section)
Generated by: Codex Supercharge maintenance automation.
Goal: keep a lightweight, up-to-date index of local source clones so future
automation runs don’t waste tokens re-scanning sources/ manually.
Refresh the inventory
From the workspace root:
python3 plugins/codex-supercharge/scripts/sources_inventory.py --write
To inventory a different folder:
python3 plugins/codex-supercharge/scripts/sources_inventory.py --sources-dir <path> --write
What this does (and does not) do
- Captures metadata only: disk size, git remote, head SHA, commit timestamp, license filename.
- Does not execute any code from the repos.
- Does not treat metadata as a trust signal.
Output location
plugins/codex-supercharge/references/source-repos.md (between inventory markers)
Skip when
sources/ does not exist.- The user is working only with remote repos (no local clone).
- You need a deep repo summary: use
$repo-intelligence-brief instead.
References
plugins/codex-supercharge/references/source-repos.md- Safety gate:
$sandbox-source-intake, $mcp-safety-review
Validation
python3 plugins/codex-supercharge/scripts/sources_inventory.py | head
