KonsolScript — Scripting Guide

Everything a script author needs to write, run, and extend KonsolScript (.ks) programs — from beginner CLI tools and game scripts to AI orchestration pipelines that wire together LLM APIs (OpenAI, Anthropic Claude, Google Gemini, Ollama) into automated, multi-model workflows.

→ Contributors and plugin authors: see contributing.md


Table of Contents

  1. What can you build? — app ideas you can ship with the built-in modules and plugins
  2. Kookbook — full project ideas, beginner to advanced
  3. Language reference
  4. Standard library modules
  5. Running scripts — the minks CLI
  6. Available plugins

What can you build?

From beginner CLI tools to AI-powered pipelines — KonsolScript's modules and plugins cover a wide range of real-world apps:

Full project ideas — beginner to advanced


Language reference

KonsolScript.md — types, operators, control flow, functions, classes, error handling, and the full standard library module reference


Standard library modules

Module Description
Konsol Terminal I/O, process control, ASCII utilities
Math Numeric operations, trigonometry, random
String Trim, split, replace, compare
File Open, read, write, close
Time Wall-clock time, process timer
List Dynamic resizable typed arrays
Map String-keyed dictionary
Json Parse, build, and serialize JSON
Array Fixed-size typed arrays
Path Path manipulation and filesystem queries
OS Working directory, env vars, process control, dir listing
Regex Pattern matching and capture groups
Date Unix-timestamp date arithmetic and formatting
Hash MD5, SHA-256, Base64
CSV Parse, build, and serialize CSV

Running scripts — the minks CLI

minks.md — how to run scripts, the REPL, flags (--check, --debug, --sandbox), exit codes, and the plugin package manager (minks install / remove / list)


Available plugins

Install a plugin once with minks install <name>, then load it in any script with #include "name".

Plugin Description
curl HTTP client — GET, POST, PUT, DELETE
sqlite SQLite database (no external dependency)
mysql MySQL / MariaDB database
zip Zip archive read/write
net LAN TCP networking