For AI agents: the complete documentation index is available at /next/llms.txt, the full documentation bundle is available at /next/llms-full.txt, and this page is available as Markdown at /next/ai/agent-lynx/troubleshooting.md.
AI logo
AI
  • English

      • Troubleshooting

      SymptomWhat to check
      No clients are listedKeep the app running in the foreground, enable Lynx Debug and Lynx DevTool, and check the device connection. On Android, confirm USB debugging is authorized.
      The wrong page is selectedRun list-clients and list-sessions again, then pass both target IDs explicitly.
      An element ref is missing or staleRun snapshot again and use refs from its latest output for the same client and session.
      The ReactLynx tree is emptyCheck the selected session and use a development build with compatible ReactLynx DevTools.
      Source information is unavailableEnable UI source-map generation and make the matching debug metadata reachable by the tooling.
      The agent reports a network-permission errorAllow the agent to reach the local daemon and device services. See Codex network configuration if applicable.

      Use agent-lynx daemon status to inspect the local daemon and <command> --help for current options. --no-daemon is for explicit direct-transport workflows; snapshot refs, ref actions, screenshot, and ReactLynx commands require the daemon.

      See Connections for daemon lifecycle and direct transports, and the CLI reference for diagnostic environment settings.

      Except as otherwise noted, this work is licensed under a Creative Commons Attribution 4.0 International License, and code samples are licensed under the Apache License 2.0.