auto-skill-build-sources-inventory

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