Find your problem below. If it is not here, see Known limitations or report it.
Sign-in
The browser asks "Continue to Trace?"
Your browser is already signed in to Trace, so the sign-in page asks you to confirm. Press Continue to Trace (Continue to Trace Plugin for the plugin) if you just pressed Sign In in the app. If the email shown is not the account you want, choose Use a different account. This is new in Trace 3.2 and Trace Plugin 2.0.
The browser says I'm signed in, but the app isn't
- If the browser asked whether to open Trace, allow it.
- If the page says We couldn't hand the sign-in to Trace, go back to the app and press Sign In again.
- If This sign-in link is not valid, go back to the app and press Sign In again.
- A sign-in you start in the app lasts 15 minutes. If it took longer, start again. In the Trace app, Account > Retry Sign In opens the sign-in page again.
"This version of Trace can no longer sign in"
Trace 3.1 and earlier, and Trace Plugin 1.1 and earlier, can sign in until December 15, 2026. After that, update to the latest version from buildwithtrace.com/download, then sign in again.
The browser did not open
Trace says it could not open the browser. Make sure you have a default browser set, then press Sign In again.
The chat says my sign-in had expired
If Trace could not reach its server for a moment while renewing your sign-in, the chat says you are still signed in and can send your message again in a moment. Wait a little, then send it again. If you are signed out, sign in again.
The email link does not work
Installation
Mac: Trace will not open
The Trace app needs macOS 12 or later on a Mac with Apple silicon (M1 or later); it does not run on Intel Macs. Trace is signed and notarized by Apple, so macOS should open it without warnings.
If macOS still refuses to open it, delete the copy you have, download it again from buildwithtrace.com/download, drag it into Applications and open it from there. If that does not help, email hello@buildwithtrace.com with your macOS version and the exact message.
Windows: "Windows protected your PC"
If you see a Windows protected your PC prompt, click More info, then Run anyway. This is normal for new applications. Only do this for an installer you downloaded from buildwithtrace.com/download.
Linux: the AppImage will not start
- Make the file executable:
chmod +x trace-*.AppImage - Install libfuse2 if it is missing. On Ubuntu and Debian:
sudo apt install libfuse2 - Run it from a terminal with
./trace-*.AppImageto see any error message.
The Trace app needs an x86_64 computer.
Getting the latest version
On Mac and Windows, choose Help > Check for Updates.... On Linux, download the latest AppImage from the download page.
Several projects
"Trace keeps up to 5 projects open at a time"
Trace keeps up to five projects open in one window. Close one you are done with: hover over it in Open Projects and click the ×, then open the new one. See Work on several projects.
I can't switch to another project
While the assistant is working, Trace keeps you in the project it is working in. Wait for the reply to finish, or press Stop in the chat, then switch.
A chat says another chat is working
In each project, one chat at a time changes the design, in Agent or Plan. If you send another such request in the same project, Trace says Trace is already working on this project in that chat, and your message stays in the box. Wait for that chat to finish or stop it, or switch your chat to Ask, which can answer questions alongside it. New in Trace 3.3.
The assistant still works in one project at a time. If a chat in one project is busy, a chat that belongs to another project keeps your message in the box. Wait for the other chat to finish, or start a new chat in the project in front.
A chat is read-only
The chat belongs to a project that is not open. Open that project to carry on, or start a new chat.
Project Issues
A project will not open
Keep the whole project folder together: the .kicad_pro project file, the .trace_sch and .trace_pcb design files, the drawing file saved beside each one, and the project's libraries. See Projects.
For a KiCad or Altium project, follow Opening projects. For a team project, open it from Workspaces.
Missing libraries or footprints
Check the part's library name, the project's library tables and the files they point to. Restore the library or assign the right part.
If Trace says a library failed to load, the library is set up but one of its files can't be read. Restore or repair that file, then restart Trace. See A library failed to load.
A placeholder rectangle means Trace could not find the symbol. It does not show whether the pins and connections are right, so compare the real part's pins, nets and footprint pads with its datasheet before you carry on. See Components.
The schematic and board are out of step
Save your work, then use Tools > Update PCB from Schematic (in the Simple layout, search for it in the Command Box, Ctrl+K or Cmd+K on Mac) and review what it will change. Run DRC afterwards.
If the board's footprints are not linked to the schematic, for example a board edited or imported on its own, the assistant stops before adding a second copy of every part and lists the references that would be doubled. It can then update the footprints in place by matching their references, the same as the Re-link footprints to schematic symbols based on their reference designators option in the Update PCB from Schematic dialog.
Save Conflict when I save a schematic
The sheet file holds changes the editor has not loaded yet, usually an edit the assistant just made. The dialog lists what saving would lose. Press Load Changes From Disk to keep them, or Overwrite only if you are sure you want the design in the editor instead. See If the file changed while it was open.
My settings or recent projects are missing after an update
From Trace 3.3, the first start of a new version brings over your preferences, recent projects and libraries from the version before, without asking. If a project is still missing from your recent projects, open it once from its folder and Trace lists it again.
My changes disappeared
- Check that the right project and, for team projects, the right branch are open.
- Look in the chat for a step that failed.
- Compare the file with its local history; see Version history.
If a design file is lost or damaged, the assistant can bring back an earlier version from the project's local history, and you can undo the restore.
Team Workspaces
Workspaces shows as unavailable after going back to an older Trace
Trace 3.2 updates the record Workspaces keeps on your computer, and older versions of Trace cannot read it. Install Trace 3.2 or later again from the download page and Workspaces works as before.
"Couldn't open" a team project
The start page says why, for example that your access changed or the project was archived, and offers Open Workspaces and Dismiss. Ask the project's owner if you think you should still have access.
A move, merge or branch switch did not finish
Read what Workspaces says: each message says what happened, that your work is safe and what to press next. See If something goes wrong in Workspaces.
The assistant
The chat says Choose model
Click Choose model and pick a model before you send. See Models.
The assistant stopped because usage ran out
When the usage for a request runs low, the assistant finishes the step it is on, sums up what is done and what is left, and the chat shows a banner with a button that opens Billing. If your plan's allowance and credits are used up, the reply says so. Choose a plan or add credits in Billing, then ask the assistant to carry on. See Billing and plans.
The connection dropped during a reply
Trace reconnects by itself, and the chat shows Reconnecting while it tries. From Trace 3.3 this also covers a restart of Trace's servers in the middle of a long request, and a connection that silently stops is noticed within a minute and picked up again. If Trace can't reconnect, the reply stops with Connection interrupted; press Resume to pick it up where it left off. A reply that finished while you were away shows up when you open the chat again. Check the design before you send the same request again. See Working with chat.
Trace asks "Agent Working" when I close something
The assistant is working in the project or editor you are closing. Choose Stop Agent and Continue to stop it and go ahead, or Cancel to let it finish.
The conversation is getting long
In a long conversation the assistant may summarize earlier messages and lose details. Restate the requirements that matter, or start a new chat for the next task.
Trace Plugin
KiCad: the plugin cannot connect
Turn on KiCad's API once:
- In KiCad, open Preferences > Preferences... (on Mac, KiCad > Settings...).
- Click Plugins, tick Enable KiCad API and click OK.
- Close the PCB Editor and Schematic Editor and open them again.
- Press Connect in the Trace Plugin.
On a Mac, allow Accessibility for Trace Plugin when macOS asks, so the plugin can refresh KiCad after the assistant's edits. See Trace Plugin for KiCad.
Altium Designer: the project is open but the plugin cannot reach it
Press Disconnect, then Connect. Open projects in Altium the usual way, from File > Open Project. See Trace Plugin for Altium.
Autodesk Fusion: edits keep stopping to ask questions (Mac)
Fusion asks questions while a schematic changes, such as which name a joined net keeps. On a Mac, Trace can answer the ones its own edits bring up once you give Trace Plugin the Accessibility permission: press Allow on the card on the plugin's Fusion screen, then switch Trace Plugin on in System Settings > Privacy & Security > Accessibility. Nothing needs restarting.
Without the permission, answer Fusion yourself, as the top of the chat tells you. See Trace Plugin for Autodesk Fusion.
Autodesk Fusion: the plugin cannot connect
If Fusion was already open the first time you connected, start the add-in once in Fusion: Utilities > Add-Ins, find TraceBridge, press Run and leave Run on Startup ticked. Make sure an Electronics design is open in Fusion. Fusion is supported on Windows and Apple silicon Macs, not Linux.
Routing and layout
Basic routing is taking a long time
The routing card shows what the router is doing and how many connections are done. Press Stop to keep everything routed so far as one step you can undo. If basic routing runs for more than five minutes, the card suggests switching to advanced routing. See Placement and routing.
An advanced run is still going
When the board is complete and nothing better has come for a while, the card offers Finish here. If time runs out with work left, Keep going gives the same run more minutes. You are charged for the compute time the card shows, also when you stop a run; Stop shows what stopping costs before you press it. See Advanced layout charges.
The advanced layout card has no Run button
Your balance doesn't cover the shortest run. The card says how much more you need: add credits from its button, then press Check again, or use basic routing, which is free. See If your balance is too low.
A Mechanical fit check fails for a part outside the case
The part sits off the board, so the case is built without it. Move it onto the board, or ask for the case to be built around it. See Parts off the board.
Exports
My manufacturer rejected the Gerber files
Compare the files with your manufacturer's requirements: board outline, layers, units, drills and assembly files. Open the files in a Gerber viewer, and run DRC with your manufacturer's rules. A clean DRC is not the same as your manufacturer's approval. See Exporting.
Parts are missing from the BOM
Check each part's reference, value, and whether it is marked Do Not Populate or excluded from the BOM, and which design variant is selected.
Network
Trace cannot reach its services
Check your internet connection and status.buildwithtrace.com. On a company network, ask your IT team whether Trace is allowed through. See Platform status.
Found a Bug?
- In the Trace app: choose Help > Report Bug. The chat opens; say what went wrong and the assistant sends the report to the Trace team with your Trace version and system details.
- In the Trace Plugin: choose Report a problem… in the menu.
- By email: hello@buildwithtrace.com.
- On Discord: the Trace community, also under Help > Join the Trace Community.
Tell us your product and version, your operating system, for the plugin your design tool and its version, what you did, what you expected and what happened, with the exact message. Diagnostic logs leave out your sign-in details, but check them before you attach them. Leave out passwords, payment details and design files you cannot share.