Reference / Help

Known Limitations

Understand feature boundaries and review requirements before relying on a result.

Use Availability to check your product, host, build, and service. A feature in Trace desktop is not automatically supported by Trace Plugin or a CLI.

AI Design Assistant

Context window limits

Long conversations can be summarized, and earlier details can be lost. Restate important constraints and check them against the current design. A remembered preference is not evidence that a design meets it.

Long Tasks and Interrupted Replies

Newer service runs are not cut off just because they have reached an old default step count or duration. They can still stop for usage or resource limits, cancellation, errors, or pending answers. Tool-specific budgets, such as an advanced-layout time limit, remain separate.

Compatible desktop/plugin builds can look up an interrupted run and display a reply that finished while the connection was absent. That does not prove a local tool completed while the application was closed. Use Resume only for the existing task when offered; do not repeat an uncertain mutation as a new request.

Ask mode is read-only

Ask is for explanation and review, not persistent CAD edits. Agent can make supported changes, and Plan proposes work for approval. All three modes use metered AI; see Billing.

Schematic Editor

Symbol library resolution

A missing symbol or placeholder does not guarantee correct pins or nets. Restore the actual library definition and verify pin numbers, electrical types, connections, and footprint assignments before proceeding.

File encoding and dependencies

Imported text and paths can expose encoding or missing-dependency problems. Preserve the original project and use supported import controls. Do not rewrite native files in a text editor just to silence an import error.

Generated parts need review

Generation and library installation are separate from validation for your board. Check the exact part/package, symbol units, pin-to-pad mapping, dimensions, and manufacturer drawing. A generated 3D model is not a fit or tolerance certification.

See Component Editor.

PCB Editor

Autoroute timeout

Placement or routing can finish with unresolved connections or reach its time budget. Review the final board, DRC, unrouted state, and charge. A completed job does not certify signal integrity, thermal behavior, or manufacturing yield.

Board outlines and fixed placement

Confirm the actual outline, layers, clearances, and approved fixed positions before layout. Protected placement is not the same as the editor's Lock flag.

The layout engines act on a whole board; asking to route one net or move one part does not authorize a whole-board run. See Placement and routing.

PCB persistence between sessions

Native .trace_pcb and .trace_sch files are saved design files, with additional data in paired .xo files. Keep the project together. A failed save or reload is not fixed by deleting sidecars, renaming extensions, or asking the AI to reapply uncertain changes.

See Project troubleshooting.

Conversion (Altium Import)

Import is not a promise of lossless round-trip compatibility. Preserve the source and review drawings, connectivity, libraries, design rules, variants, and 3D links in the imported project.

Supported conversions and their outcomes depend on the importer and version. Trace Plugin editing in Altium is a different workflow from importing an Altium design into Trace desktop.

See Importing formats and Trace Plugin.

Simulation

Simulation needs supported models, current pin bindings, and known operating conditions. Missing conditions or models can leave a requirement not evaluated.

Partial, failed, cancelled, historical, or no-assertion results do not certify the current circuit. Plots are views of saved samples, not physical measurements. See Simulation.

Cloud projects and recovery

Workspaces synchronization is not simultaneous live co-editing. Saving a local file, committing it, publishing it, and opening the cloud project are different steps.

Read-only access, unpublished edits, permission changes, or an uncertain operation can block a transition. Preserve the existing project and recovery data; use the original operation's controls. See Workspaces.

Platform-Specific

Trace Plugin host differences

Trace Plugin does not provide native Workspaces or every desktop panel merely because it shares chat UI. It has its own AI Workflows settings and, in compatible newer builds, a separate Simulation window for supported schematic exports.

Library Remediation checks and fixes supported library copies, not a live board or every possible external database. An audit, AI review and written output are separate outcomes.

KiCad save/reload automation and screenshots have platform-specific permission requirements. Altium requires a supported Windows host. Host reload can affect undo history; use the relevant KiCad or Altium guide.

Installation and updates

Use official installers for your product and architecture. Do not bypass operating-system security warnings or assume every platform's update notification performs an in-place update.

See Installation and Troubleshooting.

Report a limitation

Send a reproducible problem to support@buildwithtrace.com or Discord. Include your product, version, host, and a non-confidential example where possible.

For an improvement, use Feature requests. That page does not promise a delivery date.