Troubleshooting

Find a next step when sign-in, model selection, or CLI setup gets stuck.

Codex CLI is unavailable

Check that codex --version works in a terminal on the same machine. The app must be able to find codex on PATH. After changing the installation or PATH, restart Aerenium. A shell alias alone may not be visible to a desktop app.

The CLI asks me to sign in

Run codex login in your own terminal and complete sign-in there. Reopen the app’s provider selector afterward. An Aerethis login does not sign you in to Codex.

The provider reports a configuration or model discovery problem

Read the displayed reason. Update Codex CLI using its official instructions and check network access. Aerenium requires a fresh model list and a CLI configuration that can disable inherited tools and custom routes. If it still fails, report the reason to support; do not bypass the checks.

The reply arrives, but app tools do not run

That is expected for a CLI provider: it is a plain-text connection. Choose a supported API provider for Aerenium’s tool workflow, then review the app’s permissions and model settings.

Managed credits or downloads are unavailable

Check the signed-in Aerethis account and its available allowance. A subscription to an external CLI is separate. If the account looks correct, contact support with the visible error and app version.

Still stuck?

Include your operating system, app version, the selected provider and the visible error. Remove API keys, passwords, login tokens and private content before sending a report.