CLI Reference
Run sigil --help or sigil <subcommand> --help for up-to-date usage. This page is a tour of the common subcommands.
sigil eval
Section titled “sigil eval”sigil eval <pr-ref> --service <svc> [options]Deploy PR + baseline, run scenarios against both, score, and append eval.complete to the ledger.
sigil decide
Section titled “sigil decide”sigil decide <pr-ref> --service <svc>Apply the threshold policy to the most recent eval for this PR and emit the decision. Exit 0 (ALLOW), 1 (REVIEW), 2 (BLOCK).
sigil ci
Section titled “sigil ci”sigil ci owner/repo#42 --service <svc> [--comment] [--auto-merge] [--dry-run]eval + decide + GitHub integration in one. See CI Integration.
Scenarios
Section titled “Scenarios”sigil scenario lint
Section titled “sigil scenario lint”sigil scenario lint [--service <svc>]Parse + static-check every scenario. Verifies capabilities, metadata, and sandbox-safety rules.
sigil scenario generate
Section titled “sigil scenario generate”sigil scenario generate --from <spec> --service <svc>Five-input pipeline (spec, diff, bugs, traces, source) → LLM test plan → scenario code → three-stage validation (lint, parse, optional execution via --verify) with repair loop.
sigil generate-types
Section titled “sigil generate-types”sigil generate-types [--service <svc>]Emit .sigil/types/sigil.lua — a LuaLS type stub that gives editor autocomplete for the full DSL.
Ledger
Section titled “Ledger”sigil ledger list
Section titled “sigil ledger list”sigil ledger list [--service <svc>] [--kind <kind>] [--since <dur>]sigil replay
Section titled “sigil replay”sigil replay <eval-id>Re-execute an eval bit-for-bit from its reproducibility tuple and diff against the stored result.
sigil trust show
Section titled “sigil trust show”sigil trust show --service <svc>Operations
Section titled “Operations”sigil init
Section titled “sigil init”sigil init --service <svc>sigil deploy / sigil teardown
Section titled “sigil deploy / sigil teardown”Manual ephemeral environment management. Mostly used for debugging.
sigil override
Section titled “sigil override”sigil override <decision-id> --to <allow|review|block> --reason <text>Record a human override. Appends override.human to the ledger.
Hidden / advanced
Section titled “Hidden / advanced”sigil intent-mcp-server
Section titled “sigil intent-mcp-server”Internal MCP stdio server used when provider = "claude-code" in [judge]. Not usually invoked directly.