TraceDocs
Get Trace

Reference / Trace App CLI

Native CLI Version Notes

Identify the CLI bundled with Trace without confusing implementation notes with downloadable releases.

Identify your installed build

Install Trace and use its native executable. For AI or cloud Workspaces, launch and sign in to the main app first. If the session expires, refresh/sign in there rather than configuring a CLI token.

trace-cli --version
trace-cli version --format commit
trace-cli --help

These report the executable's version, source commit and command tree. They do not prove service deployment, account access or availability in another platform's installer.

Native implementation notes

The current native command implementation includes:

  • chat with Ask, Agent and Plan modes. Ask is read-only; Agent is the editing default. Hosted work uses the main app's existing session.
  • sch erc, pcb drc and schematic/board exporters that process saved designs with the native engine.
  • auth status to inspect the existing desktop sign-in; there is no separate native login command.
  • Workspaces saved-content reviews and original-operation receipts, with advanced actions dependent on their compatible native and service owners.

These are source capabilities, not versioned release announcements. Check installed help for each action. The CLI and its installed native libraries must remain compatible; dependency or implementation changes do not establish a downloadable standalone release.

Release and compatibility review

Use the desktop changelog for historical desktop notes, Product availability for capability boundaries and Command reference for the native command families.

Record the installed build when reporting a problem. Include the relevant command help and a safe error summary, not credentials, account-status dumps or private design content. A completed local build is not evidence of a published update.