sireen audit

Run a security audit on a single Solidity file or a Foundry project directory.

sireen audit <path> [options]

Options:
  --json              Output full JSON report to stdout
  --report            Write a Markdown report to the working directory
  --project           Treat path as a Foundry project directory
  --output <file>     Write JSON output to a specific file

Examples

# Audit a single file with Markdown report
sireen audit ./MyContract.sol --report

# Audit with JSON output
sireen audit ./MyContract.sol --json

# Audit an entire Foundry project
sireen audit ./my-project --project --json

sireen audits

List all past audits stored in the local SQLite database.

sireen audits

sireen show

Display the full details of a specific audit, including evidence packs.

sireen show <audit-id>

sireen report

Export an existing audit as a Markdown report.

sireen report <audit-id> --output report.md

Exit Codes

CodeMeaning
0CONFIRMED or CLEAN_WITH_COVERAGE
1FAILED or runtime error
2DEGRADED or UNVERIFIED
3Audit ID not found

Environment Variables

VariableDescription
OPENROUTER_API_KEYOpenRouter API key for LLM-assisted mode
SIREEN_DB_PATHCustom path for the SQLite audit database
API Key Security

Store your OPENROUTER_API_KEY in .env.local (gitignored). Never commit API keys to version control.