QML — 116 Operations for AI Agents

This page is the canonical reference an AI coding agent uses to refactor, query, and analyze QML code through the act MCP server. 116 operations available: 42 refactor, 18 query, 42 analysis, 14 verification. Each operation is callable from Claude Code, Cursor, Codex, OpenCode, or any MCP-compatible agent host. Click any operation for a stable anchor link suitable for citation.

Worked QML examples

act101 parses QML with the tree-sitter grammar and edits property declarations, signal declarations, and import statements as syntax nodes, so a retyped property or added import lands at the exact point it targets; binding-expression rewrites anchor on the syntax tree, except expression extraction, which anchors on the first textual match of the expression. It can retype a property var declaration to a concrete type such as int, keeping its initializer. It can convert a string built by + concatenation into a JavaScript template literal with ${} interpolation. It can insert an import statement at the top of the file, deduplicating against a module already imported at the same or higher version. It can strip parentheses from a binding expression that does not need them. It can collapse a set of hardcoded, identical sibling components into a single Repeater bound to a named model. And it can extract a repeated binding expression into a named property, rewriting the binding to reference it — the extraction anchors on the first textual match of the expression. Each example below is the verbatim output of the command shown, run against the file shown.

Give a var property a concrete type

Counter.qml declares count as property var, so QML boxes the value and skips type checking.

$ act refactor-lang convert_var_to_property --file Counter.qml --params '{"variable_name":"count","property_type":"int","line":1,"column":1}'

Before

import QtQuick 2.15

Item {
    property var count: 0
}

After

import QtQuick 2.15

Item {
    property int count: 0
}

The declaration becomes property int count: 0; the initializer is preserved and only the type token changes.

Convert string concatenation to a template literal

Greeting.qml's Text element builds its text binding by concatenating "Hello ", the name property, and "!" with +.

$ act refactor-lang convert_string_concatenation_to_template --file Greeting.qml --params '{"line_number":4,"line":1,"column":1}'

Before

import QtQuick 2.15

Text {
    text: "Hello " + name + "!"
    property string name: "World"
}

After

import QtQuick 2.15

Text {
    text: `Hello ${name}!`
    property string name: "World"
}

The concatenation becomes a single template literal: Hello ${name}!.

Add a missing import

Panel.qml imports only QtQuick, with no QtQuick.Controls import yet.

$ act refactor-lang add_import_statement --file Panel.qml --params '{"import_uri":"QtQuick.Controls","version":"2.15","line":1,"column":1}'

Before

import QtQuick 2.15

Rectangle {
    width: 100
}

After

import QtQuick 2.15
import QtQuick.Controls 2.15

Rectangle {
    width: 100
}

import QtQuick.Controls 2.15 is inserted on its own line, directly after the existing import QtQuick 2.15.

Remove parentheses a binding does not need

Notifier.qml wraps a simple x + y binding in parentheses.

$ act refactor-lang remove_unnecessary_parentheses --file Notifier.qml --params '{"line_number":4,"line":1,"column":1}'

Before

import QtQuick 2.15

Item {
    property int result: (x + y)
    property int x: 1
    property int y: 2
}

After

import QtQuick 2.15

Item {
    property int result: x + y
    property int x: 1
    property int y: 2
}

The redundant parentheses are dropped; the sibling property declarations are untouched.

Extract repeated items into a Repeater

ItemList.qml's Column contains two hardcoded ItemDelegate items, each bound to model.name.

$ act refactor-lang convert_repeated_to_repeater --file ItemList.qml --params '{"container_type":"Column","item_type":"ItemDelegate","model_name":"myModel","line":1,"column":1}'

Before

import QtQuick 2.15
Column {
    ItemDelegate {
        text: model.name
    }
    ItemDelegate {
        text: model.name
    }
}

After

import QtQuick 2.15
Column {
    Repeater {
        model: myModel
        delegate: ItemDelegate {
            text: model.name
        }
    }
}

The two ItemDelegate items become a single Repeater bound to myModel, with one ItemDelegate as its delegate.

Extract a binding expression into a property

Card.qml computes width * 0.5 inline in its height binding.

$ act refactor-lang extract_property --file Card.qml --params '{"expression":"width * 0.5","property_name":"halfWidth","property_type":"real","line":1,"column":1}'

Before

import QtQuick 2.15

Rectangle {
    width: 200
    height: width * 0.5
}

After

import QtQuick 2.15

Rectangle {
    width: 200
    property real halfWidth: width * 0.5
    height: halfWidth
}

A property real halfWidth: width * 0.5 declaration is inserted above, and height is rebound to halfWidth.

Query

18 query tools, the same on every supported language. Descriptions live in the shared reference: /docs/query-tools.

callers control_flow data_flow definition diagnostics effect_closure effect_summary fix_auto get_type graph import_organize interface mutations references repo_outline skeleton symbols symbols_batch

Refactor

Analysis

42 analysis tools, the same on every supported language. Descriptions live in the shared reference: /docs/analysis-tools.

analyze_api_diff analyze_chokepoints analyze_clones analyze_clusters analyze_cohesion analyze_conformance analyze_coupling analyze_cycle_risk analyze_cycles analyze_dead_code analyze_depth analyze_entry_points analyze_export analyze_extraction analyze_fan_balance analyze_features analyze_hotspots analyze_impact analyze_inconsistencies analyze_inheritance analyze_interface_bloat analyze_interfaces analyze_layers analyze_orphan_types analyze_patterns analyze_platform_deps analyze_readiness analyze_roles analyze_seams analyze_stability analyze_surface analyze_test_gaps analyze_thickness analyze_type_completeness churn_hotspots co_change_clusters coverage_overlay ownership_map profile_overlay simulate split_module trace_overlay

Verify

14 verify tools, the same on every supported language. Descriptions live in the shared reference: /docs/verification.

bisect_regression gate generate_test_harness scan secret_surface summarize_pr taint_flow unsafe_surface verify_behavioral_equivalence verify_contract_preserved verify_diff_semantics verify_port_parity verify_side_effects verify_test_impact