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
On Mac and Windows, choose Tools > Install trace-cli Command in the Trace app. On Linux, trace-cli comes inside the Trace AppImage.
trace-cli auth loginThen 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.