devflow-connect

The "Cannot connect to agent" error occurs when the DevFlow agent inside a running .NET MAUI app is unreachable from the maui CLI. This usually stems from a missing DevFlow agent NuGet integration, the broker not running, or blocked ports.

Fix Android emulator connectivity by verifying and reconfiguring adb forwarding or adb reverse settings. The troubleshooting process diagnoses misconfigured emulator networking and applies platform-specific port tests to restore access to the DevFlow agent.

If DevFlow agents are missing, first run the command "maui devflow list" to confirm visibility. You should then validate the broker status, verify the DevFlow agent NuGet initialization, and check for port conflicts blocking broker discovery.

Test broker reachability by validating the broker status, discovering connected agents, and sending a shallow visual tree request. This verifies agent connectivity and helps isolate whether the failure is a network port block or an initialization issue.

Yes, troubleshooting adapts to the platform. Android requires adb forwarding and reverse configurations for emulator networking, while iOS, macOS, Windows, and Linux rely on direct localhost checks to resolve agent connection issues.

Resolving port 9223 conflicts involves running platform-specific port and connectivity tests to identify the blockage. The recovery process guides you through clearing the port conflict and restarting broker discovery to restore interactive tooling access.