AI Assistant

MH AI — Macro Handler's built-in assistant

MH AI is a smart assistant that can chat naturally, knows the app, and designs macros for you through an approval gate. Pick from cloud providers such as Gemini, OpenAI, Claude, Groq, DeepSeek, Qwen, and more as the brain (BYO API key); on-device local models are on the roadmap.

MH AI works in three bands

Depending on your message, MH AI picks a different prompt family. General chat is light; an app question is grounded; an automation request is structured and approval-gated.

Band 1

Free Conversation

Greetings, smalltalk, generic questions get a natural answer. Off-topic is welcomed; MH AI politely notes that its primary expertise is Macro Handler.

Band 2

App-Grounded Question

Questions like "how to use Region" or "OCR in no-code" are answered from ScriptApiCatalog and VisualBlockRegistry. The model cannot invent APIs.

Band 3

Automation Proposal

"Build me a macro" requests produce a structured JSON proposal. Validator → risk → preview → YOUR approval → apply → rollback if needed.

You choose which brain to use

In the current release path, you can choose from 14 cloud providers with your own API key. The on-device local model catalog is on the roadmap; once release-ready, it will use the same capability registry, safety rules, and approval flow.

Google Gemini

Cloud — high capacity, multimodal. API key is BYO (bring your own).

OpenAI GPT

Cloud — structured macro proposal via function-calling. BYO key.

Anthropic Claude

Cloud — stable across long contexts, safety-aware. BYO key.

Groq

Cloud — low-latency high-speed inference. BYO key.

DeepSeek

Cloud — code-oriented models. BYO key.

Qwen

Cloud — Alibaba Qwen models (OpenAI-compatible endpoint). BYO key.

xAI Grok

Cloud — xAI Grok models. BYO key.

OpenRouter

Cloud — multi-provider routing behind one key. BYO key.

Cerebras

Cloud — high-speed inference. BYO key.

Fireworks

Cloud — open-weight model hosting. BYO key.

Perplexity

Cloud — search-grounded answers. BYO key.

Mistral

Cloud — Mistral models. BYO key.

Together

Cloud — Together AI model hosting. BYO key.

Cohere

Cloud — Cohere Command models. BYO key.

Gemma / Phi / Llama (yerel — yakında)

On-device local models (coming soon). Will run without internet once released.

What you can ask

MH AI auto-classifies your message; each class routes to the right pipeline.

General Chat

Greetings, smalltalk, off-topic — natural answer; Macro Handler primary expertise is politely noted.

Macro Handler Question

Questions about API, blocks, no-code/code editor. Grounded answer from ScriptApiCatalog + VisualBlockRegistry.

Macro Planning

Natural-language macro brief → structured JSON proposal. Only registered capability IDs are used.

Code / No-Code Generation

Lua script for the code editor or block chain for the no-code workspace. Everything flows through approval.

Audit / Fix

Inspects your active macro, surfaces issues, proposes fixes — you approve before anything applies.

Observe-Learn / Live Takeover

AI learns while you act or assists live. Still routed through the approval gate.

Safety rules

AI cannot hallucinate, bypass your approval, or propose risky actions. Every rule is locked in by tests.

Never executes directly

AI only produces a plan. CodeEditorWriter, NoCodeWorkspaceWriter, and AndroidControlLayer require approval.

Rejects hallucinated capabilities

If a proposal references an unknown capability id, the safety gate rejects it; after a single retry, a clarifying question is shown.

Dangerous operations blocked

Denylisted actions (payment, account deletion, root, wipe) cannot be proposed by any provider.

"I applied/saved" claim blocked

If the provider claims it already applied or ran the macro, that approval-bypass false-claim is rejected.

Low confidence → clarifying question

When the model reports low confidence, MH AI asks what you actually want instead of auto-applying.

Approval flow

When AI produces a proposal, this is the path it takes — nothing moves without you.

  1. 1Message
  2. 2Intent classifier
  3. 3Context + capabilities
  4. 4Plan / proposal (JSON)
  5. 5Validator + Safety gate
  6. 6Preview
  7. 7Your approval
  8. 8Apply + Rollback

Where you use it

In the no-code workspace

Open the MH AI panel and type something like "find Y in app X, tap it, wait 1 second, repeat". AI proposes the right block chain; you approve, and it lands in the no-code workspace.

Go to no-code

In the code editor

Get a Lua draft from a sentence like "find a template in Region, tap if found, wait 500 ms". AI uses code from ScriptApiCatalog while the sandbox boundary stays intact.

Go to code editor

Install Macro Handler — MH AI is with you

After installing, the MH AI panel is one tap away on every screen. Pick a provider, paste your key, start building macros.