Find the issue
Validation errors, missing inputs, surprising outputs.
Vulcan Analyst CLI
Ask your HEM model what's wrong
Vulcan Analyst is a terminal AI agent that reads your local Vulcan workspace, explains validation and scenario results, and drafts the next modelling step for review.
vulcan-analyst
oak-terraceHEM workspacemodel: BYO
$vulcan-analyst ./oak-terrace
okworkspace loaded
ok1 model, 3 scenarios
>Why did overheating get worse after the glazing change?
runinspect_model oak_terrace.csv
runcompare_scenarios baseline glazing-change shading-option
runsearch_guidance solar gains overheating
AIThe glazing lowers heat demand, but raises late-afternoon solar gains.
AILiving-zone discomfort rises by 42 hours.
ref+42 discomfort hours, west glazing +18%
nextvulcan-analyst scenario create shading-check --preview
>Ask about validation, comfort, cost or compliance
Use it when
The model stops making sense
Compare options
Ask what changed between scenarios and why.
Draft the fix
Create reviewed CSVs, configs, or parameter changes.
Runs from the terminalUses local Vulcan workspacesBring your model accessReview before writing files