Troubleshooting

fgai is not found

Build or install the binary:

make build
./bin/fgai --help

or:

make install
fgai --help

If you installed with a custom prefix, ensure PREFIX/bin is on PATH.

fgai configure rejects a token

fgai configure accepts service-user access keys only. Use explicit auth commands for other provider families:

fgai auth login --profile dev-intl --token "$DOTID_TOKEN"
fgai sts exchange-token --profile dev-intl --subject-token-file ./github-oidc.jwt --audience hello-api

Local credentials should not affect my real profile

Set FGAI_CLI_HOME for isolated tests:

FGAI_CLI_HOME="$(mktemp -d)" fgai auth status

Live tests accidentally target production

Production live tests require FGAI_DOTID_ALLOW_PROD=1. Leave it unset during normal development.