KonsolScript

Ship once. Evolve forever.

KonsolScript is a lightweight embeddable scripting runtime for live applications, automation, AI orchestration, and game systems.

Embed it once, and your software becomes programmable at runtime - without rebuilds, redeploys, or touching the core binary.

KonsolScript lets applications load hot-reloadable scripts for behavior, workflows, events, automation, and AI-generated logic through a controlled runtime boundary.

With plugins for HTTP, databases, networking, filesystems, and more, KonsolScript acts as a live orchestration layer between your software and continuously evolving logic.

AI systems can safely generate and execute scripts inside sandboxed runtime environments while the host application remains stable and deterministic.

minks provides the developer interface for running, debugging, auditing, and exploring scripts through a REPL, sandbox tools, and production execution workflows.

I want to…	Go to
Write `.ks` scripts	Scripting Guide
Extend the engine or write a plugin	Contributing Guide

The AI never touched the game binary

A designer types: "spawn an ice storm with golems"

An AI generates KonsolScript. The script is sent over the network. The running game reacts - live.

DemoGame:SetWeather("blizzard");
DemoGame:SpawnWave("ice_golem", 4);
DemoGame:PlaySound("thunder_rumble");

No rebuild. No redeploy. The binary never changed.

→ AI Event Bridge demo

Why KonsolScript?

Live patch behavior - update running app logic without rebuilding or redeploying
Embed into any C++ app - add a full scripting layer in minutes
AI-safe runtime - AI can generate and dispatch scripts without touching the binary
Hot-reload from disk - scripts reload automatically when files change
Orchestrate AI workflows - wire any LLM API into automated pipelines
Extend with plugins - HTTP, databases, crypto, networking, and more

See it in action

#include "kse_curl"

Var:String apiKey;
OS:GetEnv("ANTHROPIC_API_KEY", apiKey);

Var:String prompt = "Explain KonsolScript in one sentence.";
Var:String body = """{"model": "claude-haiku-4-5-20251001", "max_tokens": 256,
  "messages": [{"role": "user", "content": "${prompt}"}]}""";

Curl:SetHeader("x-api-key", apiKey);
Curl:SetHeader("anthropic-version", "2023-06-01");
Curl:SetHeader("Content-Type", "application/json");

Var:String reply;
Curl:Post("https://api.anthropic.com/v1/messages", body, reply);
Konsol:Print(reply);

→ Full Claude chat script - with error handling, JSON parsing, and response extraction

→ Hello World demos - fetch + JSON, AI chat, number guessing game, AI log triage

What can you build?

AI event bridge - natural language commands that mutate a live running application
Scriptable game engine - hot-patch game rules mid-session without touching the binary
Automation pipeline - file processing, log triage, multi-step CI orchestration
Networked scripting host - push behavior updates to remote embedded instances over TCP
Moddable application - ship your app, let users extend it with .ks scripts
LLM orchestration tool - chain OpenAI, Claude, Gemini, or Ollama in one workflow

→ Full project ideas - beginner to advanced

Batteries included

Built-in: Konsol · Math · String · File · Time · List · Dictionary · JSON · Path · OS · Regex · Date · Hash · CSV

Plugins: HTTP · WebSockets · TCP · SQLite · MySQL · PostgreSQL · Redis · Zip · Crypto · JWT

Plugins are drop-in shared libraries loaded with #include "kse_name" - no recompile needed.

→ All modules · All plugins

Embed in minutes

#include "kse.hpp"

Engine engine;
engine.loadScript(source, "./scripts", "main.ks");
engine.run();

// Hot-reload changed logic without restarting:
engine.reloadFile("scripts/ai_behavior.ks");

Turn your application into a programmable platform.

→ Full embedding guide

Built for the AI era

AI systems need a safe surface to act on. KonsolScript provides one.

Scripts are audited before execution - install a guard that inspects, validates, or rejects any script before it runs
AI workflows orchestrate multiple models - wire OpenAI, Claude, Gemini, or local Ollama via the curl plugin
Live systems evolve remotely - push behavior updates over TCP to any running embedded engine

→ Execution control and trust model

→ How to prompt an LLM to generate KonsolScript - full language reference, system prompt template, host module API pattern, working calling example

Language reference

→ Language reference