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.
Commands
Section titled “Commands”| 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. |
Examples
Section titled “Examples”Ask one question:
tracex -c "how many orders failed with card_declined today?"Pipe input in, for example to ask about your current changes:
git diff | tracex -c "could this break anything in production?"tail -n 200 error.log | tracex -c "what's going on here?"Ask a specific project from anywhere:
tracex -c --ask --project <id> "what changed in payments this week?"In a session
Section titled “In a session”| 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. |
Environment
Section titled “Environment”| 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. |
Usage and limits
Section titled “Usage and limits”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.