AC Bridge
Start free trial
Start free trial

How to set up AC Bridge, step by step

Last updated

From first launch to a light that follows your project folder. Screenshots are from the real app, with sample devices and a few lines tidied.

This guide starts once the app is installed. First launch covers what Windows, macOS and Linux show the first time you open it.

Sign in and pass the checks

The app needs your account, and one quick check of this computer.

  1. Step 1

    Sign in to the app

    AC Bridge sign-in window with the product name and a button to sign in
    Screenshot: the window you see when the app first opens.

    Open AC Bridge and use the account you made on the website. Sign-in finishes in your browser, then the app comes back.

  2. Step 2

    Pass the first-run checks

    Setup card with a green tick beside each check and a Continue button
    Screenshot: every check is green, so Continue is open.

    The app looks for Claude Code or Codex and adds its small plugin. If a row is not green, press Approve, then Continue.

Start the bridge and scan

The bridge does the work on your network, so it comes first.

  1. Step 3

    Press Start

    Main app window with the bridge badge showing it is running
    Screenshot: the badge once the bridge is running.

    Press the Start badge and leave it on. AC Bridge runs on one computer at a time; the last one you start takes over.

  2. Step 4

    Run a scan

    Scan results listing a sample lamp, a Hue Bridge and a plug that needs setup
    Screenshot: a finished scan, sorted into three groups.

    Open Scan from the menu and start it. Devices it can add sit at the top, hubs and bridges come next, and anything that needs a sign-in or key is listed last.

  1. Step 5

    Add a device

    Small dialog asking for a device name, with a Connect button
    Screenshot: name the device, then connect it.

    Press Connect on a row, keep the name or type your own, and press Connect again.

  2. Step 6

    Check it on Devices

    Devices page with the sample Desk Lamp listed
    Screenshot: the new lamp on the Devices page.

    Open Devices from the menu. Everything you add shows here, and this is where you try a device.

Open Integrations from the menu, or use a row's button in Scan. Keep the bridge running: these steps run on it.

  1. Step 7

    Philips Hue

    Hue pairing form with the bridge address filled in and a Pair button
    Screenshot: the address comes from the Scan row.

    No Hue account needed. Press the round link button on top of your Hue Bridge, then click Pair within about 30 seconds. Its lights come in with it.

  2. Step 8

    Link your own server

    Home Assistant form with a sample address and a recommended sign-in button
    Screenshot: type the address you use to open Home Assistant.

    Enter your server's address and choose Sign in with Home Assistant. A token works too, under Use a token instead.

  1. Step 9

    Tuya and Smart Life

    Tuya form with numbered setup steps, a Paste button and an Access ID field
    Screenshot: follow the numbered steps, then paste your keys.

    This one takes a free Tuya developer key and about five minutes. Copy the Access ID and Access Secret from your Tuya project, press Paste, then Fetch keys.

  2. Step 10

    Meross and SONOFF

    Meross sign-in form with a sample email address and a Sign in button
    Screenshot: the same form serves eWeLink for SONOFF.

    Sign in once to fetch their local keys. After that they run entirely on your network. SONOFF devices set to local mode need no account.

  1. Step 11

    Add what the link found

    Scan panel with a banner saying Tuya is linked and an Add all button
    Screenshot: the app returns to Scan after a link.

    After a key fetch the app goes back to Scan. Press Add all, or add each device yourself.

  2. Step 12

    Brands that need no link

    Scan panel with a sample WiZ lamp ready to add
    Screenshot: a WiZ lamp, ready to add with no account.

    Scan adds Kasa, WiZ, LIFX and Shelly with no account. For Govee, turn on LAN Control in the Govee app first. Most Tapo devices ask once for your TP-Link app login.

Choose the colours and the folder

A profile says what each agent state does. A folder decides which profile runs.

  1. Step 13

    Make a profile

    Profile editor with the Working state open and a sample lamp set to On
    Screenshot: a sample profile with one state set.

    Open Profiles, press Add profile and choose Claude profile or Codex profile. A new profile starts blank. Add your devices, then pick what each state does.

  2. Step 14

    Bind your project folder

    Bridges page with a sample project folder set to the Desk lights profile
    Screenshot: the folder now uses the sample profile.

    Open Bridges, press New and choose Add a single folder. Open the row and pick your profile.

That is the setup. Run Claude Code or Codex in that folder and watch the light.

Start free trial

Stuck? When the bridge will not start has the fixes.