<nil>NILScript

Reference

Comparison

NILScript is an open specification for agent ↔ system operations — not a workflow product, an agent framework, or an API gateway. Here is how it sits beside the alternatives.

Standard vs product

The distinction that matters most is what the spec guarantees versus what you build yourself. NILScript defines a wire protocol and a DSL that any conformant system can implement; it is not something you run.

Capability matrix

CapabilityRaw APIsMCP / function callingn8n / ZapierNILScript
Neutral across backendsNoPartialPartialYes
Agent-authored at runtimeNoYesNoYes
Preview before side effectNoNoNoYes
Tiered human approvalDIYDIYManual nodesBy spec
Idempotency + audit by specNoNoVariesYes (G4, G6)
Safe by constructionNoNoPartialYes
Intent, not implementationNoPartialNoYes
Durable executionNoNoYesYes
Governed reversal by specNoNoPartialYes
Every row is a real trade-off
The question is not which tool is “better” but how much safety the spec guarantees for you versus how much you wire up yourself.

NILScript and MCP

MCP and NILScript solve different problems and compose cleanly. MCP standardizes how agents read and call tools; NILScript standardizes how agents operate a business — propose, approve, and commit consequential actions. An agent can use MCP to read context and NILScript to act on it, under a scoped grant with a preview the owner approves. The shared lineage is deliberate: a protocol you conform to, not a runtime you operate.

vs workflow tools

Workflow tools are products where a human designs flows ahead of time in a GUI. NILScript is a specification where an agent authors flows at runtime as validated DSL programs.

n8n / Zapier / MakeNILScript
Who authors the flowA human, ahead of timeAn agent, at runtime
What it isA hosted productAn open spec + reference
Backend couplingPer-connectorAny conformant system
Safety modelManual approval nodesTiers, previews, grants by spec
Failure recoveryEngine-dependentDurable; non-determinism quarantined

If flows are fixed and human-designed, a workflow tool is the right call. NILScript exists for when an agent decides what to do at runtime and it still must be safe, previewable, and auditable.

vs raw APIs

Raw APIs give maximum power and zero guardrails — and connecting M agents to N systems is the M×N problem, with hallucinated amounts going straight through. Hardcoded workflows are safe but rigid, encoding only the flows you anticipated, for one backend. NILScript collapses the false choice: an agent authors a plan at runtime (flexibility), and validation, two-phase commit, scoped grants, and tiered approval keep it safe.

Hallucinations die at the server
The agent proposes intent; the system validates, previews, and decides. The agent never executes anything directly.

NILScript is an open standard, stewarded by the Wosool project. The spec is extracted from running code.

Draft standard v0.3.0 · 0.x stage · NIL wire 0.1 · DSL 0.1