KonsolScript Kookbook

KonsolScript's project cookbook - real-world app ideas you can build with the built-in modules and plugins. Each entry lists the key pieces from the lego set that make it possible.

→ Built-in modules · Plugins

Beginner Projects

CLI Tools & Automation

→ Full guide with inline scripts

• File organizers - rename, move, and sort files by extension or date (File, Path, OS, Date) → sample
• Build/task scripts - run commands, check paths, and report status (OS, Path, Konsol) → sample
• Log analyzers - parse structured logs with regex patterns and extract insights (File, Regex, String, Date) → sample

Data & Text Processing

→ Full guide with inline scripts

• CSV processors - filter, transform, and merge datasets (CSV, List, Dictionary, File) → sample
• JSON converters - read API responses, reshape data, output new formats (JSON, Dictionary, File) → sample
• Report generators - combine CSV/JSON sources into formatted output files (CSV, JSON, String, File) → sample

Games & Interactive Apps

→ Full guide with inline scripts

• Text adventures - branching story games with inventory and state (Konsol, List, Dictionary, Class) → sample
• Trivia / quiz games - interactive Q&A with score tracking (Math, Konsol, List) → sample
• Turn-based strategy - tile maps, unit movement, simple AI (Array, List, Dictionary, Math, Class) → sample

Web & Network

→ Full guide with inline scripts

• HTTP API clients - call REST APIs and process JSON responses (kse_curl plugin, JSON, String) → sample
• Web scrapers - fetch pages and extract data with patterns (kse_curl plugin, Regex, File) → sample
• LAN chat / messaging - simple peer-to-peer TCP messaging (kse_net plugin, Konsol) → sample

Database-Backed Apps

→ Full guide with inline scripts

• Local databases - store and query structured data without a server (kse_sqlite plugin, List, Dictionary) → sample
• MySQL-backed tools - read/write from shared team databases (kse_mysql plugin, JSON, CSV) → sample

Security & Encoding

→ Full guide with inline scripts

• Checksum verifiers - compute and compare MD5 / SHA-256 hashes (Hash, File, Konsol) → sample
• Base64 encoders/decoders - encode attachments or API tokens (Hash, String) → sample

File & Archive Utilities

→ Full guide with inline scripts

• Zip bundlers - package project files into archives (kse_zip plugin, Path, File) → sample
• Config readers - parse JSON or CSV config and apply settings at runtime (JSON, CSV, Dictionary) → sample

Advanced Projects - AI Orchestration

KonsolScript is a capable AI orchestration scripting language. The kse_curl plugin paired with the JSON module connects to any LLM REST API - OpenAI, Anthropic Claude, Google Gemini, Ollama, or any self-hosted model. From there you can build full AI orchestration pipelines: route prompts across models, cache responses, annotate datasets, index knowledge bases, and automate LLM-driven workflows - all in a clean, readable .ks script with no boilerplate.

AI API Integration

→ Full guide with inline scripts

• LLM prompt pipeline - batch-process files through an AI API, collect responses to CSV (kse_curl plugin, JSON, File, CSV, List) → sample
• Semantic cache - hash prompts with SHA-256, store responses in SQLite, skip the API call on a hit (Hash, kse_sqlite plugin, kse_curl plugin, JSON) → sample
• Multi-model router - pick different LLM endpoints by task type, token budget, or latency (kse_curl plugin, JSON, Dictionary, Time) → sample

Data + AI

→ Full guide with inline scripts

• Dataset annotation runner - read CSV rows, send each to an AI API, write back labeled results (CSV, kse_curl plugin, JSON, File) → sample
• AI-assisted data cleaner - send messy CSV rows to an LLM for normalization, output clean CSV (CSV, kse_curl plugin, JSON, File) → sample
• Knowledge base indexer - chunk local files, call an embeddings API, store vectors in SQLite (File, Path, kse_curl plugin, JSON, kse_sqlite plugin, Math) → sample

DevOps + AI

→ Full guide with inline scripts

• AI log triage - scan logs with Regex, send anomalies to an LLM, output a report (File, Regex, kse_curl plugin, JSON, Time) → sample
• AI model benchmarker - run prompts against multiple endpoints, time responses, compare outputs (kse_curl plugin, JSON, Time, CSV) → sample
• Automated code reviewer - scan a folder of .ks files and send each to an LLM for review (OS, File, kse_curl plugin, JSON, String) → sample

Infrastructure

→ Full guide with inline scripts

• Local AI gateway - TCP server that accepts requests and proxies them to a remote LLM (kse_net plugin, kse_curl plugin, JSON) → sample
• Webhook receiver - listen for incoming payloads over TCP and route them to an AI endpoint (kse_net plugin, JSON, kse_curl plugin, Dictionary) → sample

AI-Driven Live Scripting

→ Full working demo

The demo_ai_bridge ships with minks as a complete, runnable example of the most powerful thing KonsolScript enables: an AI that writes and executes code inside a running application - without touching the binary.

• AI event bridge - a C++ game host embeds libkonsolscript and exposes a custom DemoGame: module (wave info, weather, spawning). A .ks script takes a natural-language prompt, calls the Claude API, receives a generated KonsolScript event script in response, and ships it over LAN to the host. The host runs it live via engine.eval(). The AI reacted to game state and authored real behavior - the game binary never changed (kse_curl plugin, kse_net plugin, JSON, embedded libkonsolscript)

The pattern generalizes to any domain: replace DemoGame: with your own module, replace the game host with your application, replace game_master.ks with any trigger - a cron job, a webhook, another AI. Multiple hosts on different machines can each run their own engine and be orchestrated from a single .ks script.