Skip to content

vulnetix aibom

Discover AI coding agents, AI SDKs, model names and AI infrastructure in a project and write a CycloneDX AI bill of materials.

Updated 02 Nov 2026Markdown

vulnetix aibom finds evidence of AI coding agents and AI use in a project and writes an AI Bill of Materials in CycloneDX.

vulnetix aibom [path] [flags]

Detection passes

Pass Reads Skipped by
Environment Known AI tool and provider environment variable names. Values are never read, so secrets never reach the AIBOM. --no-env
Filesystem Tool config directories, instruction files, ignore files, skills, hooks, plugins, steering, memory, prompts, agents, commands and marketplace manifests always runs
Source code AI SDK and framework use per language, and the model-name literals passed to them. Names are read from the SDK parameter (model=, modelId=, deployment_name=), so unknown and future models are still found. --no-source
Commit history Commits authored by an agent: Co-Authored-By trailers, session markers, agent bot authors, “Generated with” lines. Reads at most --commit-scan-max commits from HEAD. --no-commits
IaC Kubernetes manifests (including KServe, Kubeflow and KubeRay resources), compose files, Dockerfiles and Terraform: serving runtimes, agent platforms, vector databases, training frameworks, declared models, model volumes, GPU requests, managed AI services --no-iac

The built-in catalog is version 2026.06.4: 84 AI coding agents, 73 AI provider services, 2 cross-tool conventions (AGENTS.md, .mcp.json) and 102 AI SDKs. See Supported agents and providers, AI SDKs and AI infrastructure.

Flags

Flag Type Default Description
[path], --path string . Directory to scan
--depth int 25 Maximum recursion depth
--ignore string, repeatable Glob of paths to skip
-o, --output string pretty Terminal output: pretty (alias table), json (raw detections), cyclonedx-json. The file is written whichever you choose.
--output-file string <path>/.vulnetix/ai-bom.cdx.json Where the AIBOM is written
--spec-version string 1.7 1.6 or 1.7
--catalog string Catalog file to merge over the built-in one. See AIBOM catalog format.
--no-builtin-catalog bool false Use only --catalog
--no-env bool false Skip the environment pass
--no-source bool false Skip the source pass
--no-commits bool false Skip the commit-history pass
--no-iac bool false Skip the IaC pass
--commit-scan-max int 2000 Most commits the commit-history pass reads
--include-home bool false Also look for tool config directories in your home directory
--include-system bool false Look in every account’s home (/home/*, /root), not just yours
--system-root string / The filesystem --include-system describes: a mounted volume, an unpacked image, or /proc/<pid>/root
--no-upload bool false Do not send the AIBOM to Vulnetix. It is sent automatically when you are authenticated.
--aibom-include-ignored bool false Include files matched by .gitignore
--lifecycle string derived Comma-separated lifecycle phases, overriding the derived set
--project, --cluster, --namespace, --environment, --tag string inferred Deployment labels. See Document identity and deployment labels.
--sign bool false Sign the document with this machine’s OIDC identity. See Signing documents.
--bom-manufacturer, --bom-manufacturer-url string repository owner metadata.manufacturer. See Who made it.
--bom-author string, repeatable metadata.authors, as Name <email>
--bom-supplier, --bom-supplier-url string metadata.supplier
--bom-serial, --bom-version string, int new UUID, 1 serialNumber and version
--component-name, -version, -type, -group, -purl string from git metadata.component. See The subject component.
--bom-license string, repeatable metadata.licenses, the licence of the document
--bom-property name=value, repeatable metadata.properties
--bom-overlay string, repeatable A CycloneDX fragment merged in before validation. See Overlay files.

The identity, deployment and signing flags arrived in CLI v4.15.0 and work as they do on cdx. See Author and customise.

--disable-memory (a global flag) turns off the memory tracking described below.

Examples

vulnetix aibom                                  # summary; writes .vulnetix/ai-bom.cdx.json
vulnetix aibom ./myproject -o json              # raw detections as JSON
vulnetix aibom -o cyclonedx-json                # CycloneDX to stdout, still saved to the file
vulnetix aibom --output-file build/aibom.json   # a different path
vulnetix aibom --no-env --no-source             # filesystem, commit and IaC evidence only
vulnetix aibom --catalog ./extra-rules.json     # extend the built-in catalog

Output document

Detection CycloneDX component
AI coding tool application
AI SDK library
Model name machine-learning-model, with a modelCard
Model weight file in the repository data

Evidence is carried in vulnetix:ai/* properties. A value the IaC pass could not verify carries vulnetix:ai/confidence-gap set to true and a vulnetix:ai/gap-reason. The document is schema-validated before it is written. It names vulnetix-aibom in metadata.tools and claims the design and discovery lifecycle phases. metadata.manufacturer is your organisation, resolved as for cdx. Before CLI v4.15.0 only the git owner was used.

Memory and resolved components

Detected components are tracked in .vulnetix/memory.yaml. A component missing from a later run is marked resolved and recorded in .vulnetix/vex-aibom.openvex.json.

Ignoring a component

vulnetix ignore add --category ai --value claude-sonnet-4 --type false_positive --reason "test fixture string"

--value is the model id or purl. An ignored AI component is also hidden in the Resolve Platform. See Ignore rules.

Inside a scan

vulnetix scan runs the same catalog and pipeline as one of its passes. Turn it off with vulnetix scan --no-aibom.

vulnetix aibom the pass inside vulnetix scan
Passes chosen with --no-env, --no-source, --no-commits, --no-iac all
CycloneDX file written yes no
Terminal output yes no
Memory tracking yes yes
Sent when authenticated yes, unless --no-upload yes

Privacy

The environment pass records variable names and whether they are set, never their values. No source content is uploaded.

esc
↑ ↓ move↵ openSearches in your browser. A key like autonomy.max or a code like threshold_required jumps straight to it.