wire it to your agent

Read https://cr8script.com/agents.html in full and use it as your reference whenever you write, run, or repair cr8script. For any non-trivial task, also read https://github.com/LofiFren/cr8script/blob/main/LLM_MAP.md and build a typed plan graph before generating code. Loop strictly: plan -> write .cr8 -> run --check-json -> fix every issue -> run.

pip install cr8script

You are writing cr8script, not Python. cr8script is an English-shaped
scripting language with honest types (no truthy/falsy, no silent
coercion), decimal numbers (`0.1 + 0.2` is exactly `0.3`),
1-based lists, and `end`-terminated blocks. Function syntax is
`to name(args) ... end`, not `def name(args):`.

Before claiming a script works, run
`cr8script --check-json file.cr8` and fix every issue in
the JSON output. Each issue has `{line, message, hint}` -- apply the
hint, re-check, repeat until the list is empty. Then run the script.

For non-trivial tasks (multi-stage pipelines, code generators,
anything that would otherwise be blank-page generation), build a
typed plan map per `LLM_MAP.md` before writing code -- nodes
for goals, inputs, transforms, decisions, risks, outputs, and checks.
The map is the planning artifact; the `.cr8` is the execution
artifact. Skip this step for one-shot lookups and small transforms.

Hard rules -- these are errors, not warnings:

- Use `is`, `is not`, `is greater than`, `is less than`, `is at
  least`, `is at most`. Never `==`, `!=`, `>=`, `<=`.
- Lists are 1-based. `xs[0]` is an error. Use `xs.first` / `xs.last`
  or `xs[1]`.
- `if` requires a real boolean. `if 0 then`, `if "" then`,
  `if [] then` are all errors.
- Records are values. `r.field` requires the field to exist. Use
  `r.get("key")` for safe lookup (returns `nothing` on miss).
- Only `nothing` for absence -- no `null`, `None`, `undefined`.
- `let` is immutable. Reassignment requires `var`.
- Pipelines (`|`) only operate on lists. Verbs are `where`, `sort
  by`, `take`, `map`, `group by`, `summarize`. Inside `where` /
  `sort by` / `map`, bare names auto-resolve to fields of each item.
- `show` is a statement, no parens: `show "hi"`.

The full reference is in `LLMS.md`. The plan-graph format and its
validator (`tools/check_map.py`) are in `LLM_MAP.md`. The end-to-end
self-correction loop demo is in `examples/agent_loop/`.

{
  "name": "cr8_check",
  "description": "Static-check a cr8script file. Returns a JSON list of issues. Empty list = clean.",
  "input_schema": {
    "type": "object",
    "properties": {
      "path": { "type": "string" }
    },
    "required": ["path"]
  }
}

{
  "name": "cr8_run",
  "description": "Run a cr8script file. Returns stdout on success or a single-line error with line/message/hint.",
  "input_schema": {
    "type": "object",
    "properties": {
      "path": { "type": "string" }
    },
    "required": ["path"]
  }
}