firmis discover - Discover AI Platforms and Components
Synopsis
Section titled “Synopsis”firmis discover [path] [options]Description
Section titled “Description”You cannot secure what you do not know exists. firmis discover maps every AI component in your project before you scan it. It reports platforms, individual tools and skills, AI-related dependencies, and detected model files - with exact file paths for each.
Run this first on any unfamiliar codebase. The output shows exactly what firmis scan will look at and why. If a platform is missing from discover output, it will also be missing from your scan coverage.
firmis discover is read-only. It does not modify any files. For a machine-readable, audit-grade inventory in CycloneDX 1.7 format, use firmis bom instead. For immediate security findings, use firmis scan - it runs discovery automatically as part of the scan pipeline.
Detected platforms include: Claude, MCP, Codex, Cursor, CrewAI, AutoGPT, OpenClaw, and Nanobot.
Examples
Section titled “Examples”Discover all platforms in the current directory
Section titled “Discover all platforms in the current directory”npx firmis discoverDiscover a specific project path
Section titled “Discover a specific project path”npx firmis discover ./my-agent-projectDiscover only MCP servers
Section titled “Discover only MCP servers”npx firmis discover --platform mcpOutput as JSON for scripting
Section titled “Output as JSON for scripting”npx firmis discover --jsonSave discovery results to file
Section titled “Save discovery results to file”npx firmis discover --output discovery.json --jsonVerbose output - see component metadata including versions and permissions
Section titled “Verbose output - see component metadata including versions and permissions”npx firmis discover --verboseOptions
Section titled “Options”| Flag | Type | Default | Description |
|---|---|---|---|
--platform <name> | string | auto-detect | Discover a specific platform only. Accepted values: claude, mcp, codex, cursor, crewai, autogpt, openclaw, nanobot. |
--json | boolean | false | Output results as JSON instead of the human-readable format. |
--output <file> | string | stdout | Save discovery results to a file. |
--verbose | boolean | false | Show detailed component metadata including version, author, permissions, and dependencies. |
--show-deps | boolean | true | Include AI-related npm and pip dependencies in output. |
--show-models | boolean | true | Include detected model files in output. |
Exit Codes
Section titled “Exit Codes”| Code | Meaning |
|---|---|
0 | Discovery completed successfully. Zero or more platforms found. |
1 | Discovery failed with an unrecoverable error. |