TraceCommand Line

Trace in your terminal

trace-cli comes with the Trace app. Run it in a project folder for a full chat with Trace, or run checks, fixes and fabrication files from your scripts.

Get started

1. Install the Trace appDownload Trace
2. Add trace-cli to your terminal

On Mac and Windows, choose Tools > Install trace-cli Command in the Trace app. On Linux, trace-cli comes inside the Trace AppImage.

3. Sign in and starttrace-cli auth login

Then run trace-cli in your project folder.

trace-cli keeps its own sign-in, so signing it out never signs the Trace app out. If you haven't signed it in, it borrows the Trace app's sign-in. On a build server, create an API token on your dashboard and set it as TRACE_TOKEN, or pipe it into trace-cli auth login --with-token.

What you get

Full chat

Work with Trace as you would in the Trace app, with question and review cards, the price before any paid run, and typing to steer it while it works.

/ commands

/erc, /drc and /check, then /fix, plus /update-pcb, /export and /fab for Gerbers, drill and position files and a bill of materials, zipped. Each also runs on its own in scripts, such as trace-cli drc.

Previews

Terminals that can show pictures show the schematic and board in the chat, and /preview opens a live view in your browser that redraws as Trace changes the design.

Shared history

Chats from the terminal show in the Trace app's chat history, the terminal can pick up the app's chats, and /undo puts the design back as it was before your last request.

Own sign-in

Sign in with trace-cli auth login through your browser, or with an API token on a build server. Signing trace-cli out never signs the Trace app out.

No extra install

No separate download. trace-cli updates when you update Trace, and trace-cli doctor checks that everything is ready.

Ready to work with Trace from your terminal?

trace-cli comes with the Trace app. Install Trace, then sign in with trace-cli auth login.