How setup works
Every way of setting up AITrax, the CodeTogether AI tracker, runs the same underlying commands. Knowing this makes setup problems easier to reason about, because there is only one thing to inspect regardless of how setup was started.
The native commands own all configuration
aitrax setup and aitrax uninstall perform all setup-related changes. Every other surface is a
thin delegator that ends up calling them.
The following table lists what each entry point does:
| Entry point | What it does | What it does not do |
|---|---|---|
| Bootstrap script | Detects your platform, downloads aitrax, runs aitrax setup system | Write or merge configuration itself |
| The portal's Onboarding page | Issues a short-lived install token — the value that connects a workstation to a SaaS deployment — and renders the copy-paste command | Configure anything |
| IDE plugins | Detect that setup is missing, prompt, then call aitrax setup system | Write configuration |
| Update service | Serves bootstrap scripts and binaries, read-only | Apply setup logic |
The practical consequence: if setup fails, the entry point is rarely the cause. Inspect the native command and its output.
The scope
Setup has one scope: System, which configures user-level settings on the workstation.
aitrax setup check is read-only and reports the status of that scope. It is the correct first
step for any setup question.
How the binary is obtained
The bootstrap resolves your base URL, detects your operating system and architecture, and downloads the matching build into the tracker directory. Setup then runs from a throwaway copy of that binary, which avoids the file-lock failure that occurs when setup rewrites the binary it was launched from.
A small core binary handles daily tracking work. Setup escalates to a larger build that owns setup, token redemption, and diagnostics.
Related
- Files and locations — where the binaries and settings live.
- AITrax CLI reference — the commands described here.