CLI troubleshooting

These fixes cover the most common setup, authentication, terminal, and automation issues.

No profile is configured

Run trackfox config add.

API key rejected

Confirm the key belongs to the supplied website ID.

Create a replacement under Site Settings → API, then run:

trackfox config add --name PROFILE --force

Watch mode will not start

Realtime watch requires an interactive terminal and table output.

Do not combine --watch with redirected output or JSON.

Remove color from output

Set NO_COLOR=1, use --no-color, or set TERM=dumb.

Get command help

trackfox --help
trackfox analytics --help
trackfox top-pages --help
trackfox config --help

Exit codes

Code	Meaning
0	Success
1	Unexpected failure
2	Invalid arguments
3	Configuration
4	Authentication
5	Network
6	API validation
130	Interruption