KonsolScript

Ship once. Evolve forever.

Embeddable scripting runtime for games, tools, AI orchestration, and live-updating applications.

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 · Map · 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

→ Eval guard and security

→ 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