explaingit

chrishuber1/kustoforge

Analysis updated 2026-05-18

34PythonAudience · ops devopsComplexity · 2/5LicenseSetup · easy

TLDR

KustoForge is a desktop app that builds valid KQL queries for Microsoft security and Azure services through a point-and-click form instead of hand-written syntax.

Mindmap

mindmap
  root((kustoforge))
    What it does
      Form based KQL builder
      Live query preview
      Query library
    Tech stack
      Python
      PySide6
      Qt
    Use cases
      Build Sentinel queries
      Save and reload queries
      Hunt across Defender tables
    Audience
      SOC analysts
      Security engineers
      Cloud admins

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a KQL query for Microsoft Sentinel or Defender Advanced Hunting by filling out a form instead of writing syntax by hand.

USE CASE 2

Save and reload named queries, including their full filter and column setup, from a local query library.

USE CASE 3

Copy a generated query and paste it into Sentinel, Log Analytics, or Application Insights to run it.

What is it built with?

PythonPySide6QtKQL

How does it compare?

chrishuber1/kustoforgeabhisumatk/epstein_files_ragasdfo123/forgewm
Stars343434
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/53/55/5
Audienceops devopsresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.10 or higher, install dependencies with pip and run the main script.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

KustoForge is a desktop application for building queries in KQL, the query language used by Microsoft's security and monitoring services. Instead of writing queries by hand, you fill out a form: pick a service category and table, add filters, choose which columns to include, and set sorting and limits. The application generates valid KQL as you work, with a live preview that updates in real time and syntax highlighting. The application covers 52 tables across nine Microsoft service areas: Defender for Endpoint, Entra ID sign-in logs, Defender for Office 365 email data, Vulnerability Management, Microsoft Sentinel, Azure Monitor and Log Analytics, Application Insights, Azure Resource Graph, and Defender for Cloud Apps. Each table comes with column definitions and data type information, which the application uses to show only the operators that make sense for a given column. String columns get text-matching options, datetime columns get time-range operators, numeric columns get comparison operators, and so on. A query library feature lets you save the full state of a form, not just the generated query text, so you can reload a saved query and continue editing it. Keyboard shortcuts are available for copying the generated query, saving, and clearing the form. The interface uses a dark theme with Microsoft blue accents. The application is written in Python using PySide6, a set of Python bindings for the Qt graphical interface framework. You install it by cloning the repository and running pip to install dependencies, then launching the main script. There is also an option to install it as a package and run it from the command line. The project targets SOC analysts, security engineers, and cloud administrators who work with Microsoft's KQL-powered services and want to produce correctly structured queries without memorizing syntax.

Copy-paste prompts

Prompt 1
Show me how to install and run KustoForge from a fresh clone of the repository.
Prompt 2
Walk me through building a KQL query for failed Entra ID sign-ins using KustoForge's form.
Prompt 3
What Microsoft service tables does KustoForge cover, and how are they organized by category?
Prompt 4
How do I add a new table schema to KustoForge's schemas.py file?

Frequently asked questions

What is kustoforge?

KustoForge is a desktop app that builds valid KQL queries for Microsoft security and Azure services through a point-and-click form instead of hand-written syntax.

What language is kustoforge written in?

Mainly Python. The stack also includes Python, PySide6, Qt.

What license does kustoforge use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is kustoforge to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is kustoforge for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.