Automated LLM-assisted vulnerability discovery pipeline.
- Node.js >= 18
- An API key in your environment:
OPENAI_API_KEY, orOPENROUTER_API_KEY
npm package under progress soon
npm install -g open-mythosRun these 3 commands in the repository you want to analyze:
open-mythos recon
open-mythos targets --repo-name "$(basename "$PWD")"
open-mythos research --repo-name "$(basename "$PWD")" --limit 20What this does:
reconcreates and stores a threat model.targetscreates a deduplicated target queue from that threat model.researchscans unscanned targets and stores findings.
Optional dashboard:
open-mythos serve --port 7331Then open http://localhost:7331.
open-mythos --helpShow CLI helpopen-mythos --versionShow installed version
Run full pipeline (recon -> targets -> research).
open-mythos run [--repo-path <path>] [--repo-name <name>]Flags:
--repo-path <path>Path to target repository (default: current directory)--repo-name <name>Override detected repository name
Generate a threat model for a repository and store it in SQLite.
open-mythos recon [--repo-path <path>]Flags:
--repo-path <path>Path to target repository (default: current directory)
Generate target queue items from an existing threat model.
open-mythos targets [--id <n>] [--repo-name <name>] [--repo-path <path>]Flags:
--id <n>Threat model ID--repo-name <name>Filter by repository name--repo-path <path>Filter by repository path
Note: at least one filter is required (--id, --repo-name, or --repo-path).
Scan unscanned targets and store normalized findings.
open-mythos research [--threat-model-id <n>] [--repo-name <name>] [--repo-path <path>] [--limit <n>]Flags:
--threat-model-id <n>Pin research to a specific threat model--repo-name <name>Filter by repository name--repo-path <path>Filter by repository path--limit <n>Max targets pulled per batch (default:20)
Start read-only dashboard.
open-mythos serve [--port <n>]Flags:
--port <n>Dashboard port (default:7331)
Database utilities.
open-mythos db path
open-mythos db listSubcommands:
db pathPrint resolved SQLite database pathdb listList repositories present in database
| Variable | Required | Default | Purpose |
|---|---|---|---|
OPENAI_API_KEY |
Conditionally | (none) | API key for LLM calls (either this or OPENROUTER_API_KEY must be set). |
OPENROUTER_API_KEY |
Conditionally | (none) | Alternate API key for OpenRouter-compatible endpoint. |
OPENAI_BASE_URL |
No | https://openrouter.ai/api/v1 |
Base URL for OpenAI-compatible API. |
DEUS_MODEL |
No | openai/gpt-4.1-mini |
Model identifier used by the agentic loop. |
DEUS_MAX_ITER |
No | 60 |
Max iterations in the agentic loop. |
DEUS_TEMPERATURE |
No | 0.2 |
Sampling temperature for model calls. |
DEUS_APPROVAL_MODE |
No | safe |
Approval mode passed to loop config. |
DEUS_TRUNCATE_THRESHOLD |
No | 40 |
Message-history truncation threshold. |
DEUS_TRUNCATE_KEEP_RECENT |
No | 10 |
Number of recent turns to keep when truncating. |
OPEN_MYTHOS_DB_PATH |
No | src/data/open-mythos.sqlite |
SQLite file path. |
DASHBOARD_PORT |
No | 7331 |
Port used by dashboard server. |
- Fork and clone the repository.
- Install dependencies:
npm install- Set environment variables (copy from
.env.exampleif needed). - Run tests:
npm test- Validate CLI behavior locally:
node bin/open-mythos.js --help- Open a pull request with:
- clear problem statement
- focused change set
- test or validation notes