Models and AI access

Configure managed access or BYOK and choose a model and thinking level.

Linux AMD64, Linux ARM64, Windows x64 · Release 0.1.5

On this page

Two ways to fund AI

Managed access uses the AI allowance attached to your TraceForge subscription. Bring your own key (BYOK) sends provider usage to your own OpenAI account; that account bills you separately. BYOK does not replace the TraceForge application subscription.

Manual editing, saving and inspecting your local files do not require an AI response. An exhausted AI allowance is not a reason to delete or migrate a project.

Check the connection

Open a project and expand the Agent dock. Enter /status to inspect the active project, connection, model and run. Allow the project workspace to finish connecting before requesting engineering work.

Use Model in the composer, or type /model. Available models, exact identities and thinking options come from the connected service and your account's eligible routes. Older releases may show legacy profile names. A website list or a displayed model name is not proof of entitlement or successful execution; the app must report unavailability rather than silently substitute another model.

Select model and thinking level

  1. Open Model and select a ready model.
  2. Choose a supported thinking level in the model settings. Available levels can differ by route.
  3. Return to the composer and check the selected model before sending.
  4. Start with a small, read-only question, such as “Explain the power connections in this project. Do not edit any files.”

Higher effort can take longer and consume more usage; it is not a guarantee of correctness. Use Luna for a small initial task, and choose other profiles when the task warrants it. Do not infer a provider's token limit or your product allowance from the name.

Configure BYOK safely

Open the API-access option inside the model selector. Request the native credential dialog and enter your key there. Never enter a key in chat, an attachment, a project file, a support ticket or a screenshot. The web account page does not need your key.

Check /status after saving. If the provider reports authentication, credit or model-access errors, correct the OpenAI account or use managed access; changing the model's visible label cannot grant access. Removing a saved key stops that configured access path but does not revoke the key at its provider.

Private Codex developer accounts are not a customer feature and are never supplied with the application.

Understand usage and failure

Recorded usage, context occupancy, provider limits and TraceForge allowance are different measurements. Read usage and billing for the product allowance. An unknown measurement should remain unknown, not be interpreted as zero remaining credit.

If a request fails before completion, keep its run identifier and inspect the error before retrying. Do not repeatedly submit the same modifying task while its state is uncertain. See troubleshooting for service and authentication failures.

Search documentation

Type to search the TraceForge guides.