ailoha_agent 0.2.4

Ailoha agent for Flutter — runtime app inspection, interaction, and debugging from CLIs, AI agents, and IDE tooling.

ailoha_agent

Ailoha agent for Flutter

Getting started

Add ailoha_agent to your app dependencies:

dependencies:
  ailoha_agent: ^0.1.0

Usage

Initialize the agent early in your app, guarded by kDebugMode so it never ships in release builds:

import 'package:flutter/foundation.dart';
import 'package:ailoha_agent/ailoha_agent.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  if (kDebugMode) {
    await initAgent();
  }

  runApp(const MyApp());
}

Custom options

await initAgent(AgentOptions(
  appName: 'My App',
  packageId: 'com.example.my_app',
  appVersion: '1.2.3',
  enableNetworkCapture: true,
  enableLogCapture: true,
  // Sensitive network headers are redacted by default. Only set
  // disableHeaderRedaction: true for explicit local debugging.
  // disableHeaderRedaction: true,
  navigateHandler: (route) {
    // Dispatch through go_router, auto_route, or your app router here.
    router.go(route);
    return true;
  },
));

Once the agent is running, use the Ailoha CLI to connect:

ailoha agent status
ailoha ui tree --layer render --include-properties
ailoha ui tree --layer semantics
ailoha ui debug-overlays '{"debugPaint":true}'
ailoha ui wait-for-idle