Skip to content
TraceX CLI

Commands

Every TraceX CLI command, session shortcut, environment variable and file, with examples of asking questions and piping input.

Everything the TraceX CLI can do. If you haven’t installed it yet, start with Install and sign in.

Command What it does
tracex login Signs in through your browser.
tracex init Links this git repository to a TraceX project and writes .tracex.json.
tracex -c Opens a session. In a git repository it works on the local code (Coding mode); elsewhere it is like Conversations.
tracex -c "question" Answers one question and exits.
tracex -c --ask Asks the TraceX project directly, without the local code. --project <id> picks a project.
tracex status Shows who is signed in, the server, and this folder’s project.
tracex logout Ends the CLI’s session on the server and removes it from this computer.
tracex version Prints the version.

Ask one question:

Terminal window
tracex -c "how many orders failed with card_declined today?"

Pipe input in, for example to ask about your current changes:

Terminal window
git diff | tracex -c "could this break anything in production?"
Terminal window
tail -n 200 error.log | tracex -c "what's going on here?"

Ask a specific project from anywhere:

Terminal window
tracex -c --ask --project <id> "what changed in payments this week?"
Input What it does
/new Starts a new conversation.
/project Switches project.
/open Opens the conversation in the dashboard.
/exit or Ctrl+D Quits.
Ctrl+C Stops an answer.
\ at the end of a line Continues the question on the next line.
Variable Effect
TRACEX_API_URL Another TraceX server (default https://api.tracexpro.com).
NO_COLOR Turns colors off.
File What it holds
~/.tracex/credentials.json Your session (mode 0600, readable only by you).
.tracex.json The linked project, in the repository. No secrets; commit it.
~/.tracex/history Your previous questions, for the up arrow.

Questions from the CLI appear in Conversations and count toward your plan’s chat messages. If the CLI says your session ended, run tracex login again.