Skip to main content
Illustrated answers to frequent questions—scroll through as needed. Contact with [email protected] for FAQ updates.

Login doesn’t show a redirect popup

After authorization succeeds, the browser usually asks to open SoloEnt, and the page has a fallback button:
  • In the dialog, choose Open SoloEnt to allow the desktop app to launch
  • If no dialog appears, click Click here to open SoloEnt on the page
Authorization success page: browser prompt to open SoloEnt and the Click here to open SoloEnt fallback button If nothing happens, the browser is likely blocking pop-ups. In Chrome: Settings → Privacy and security → Site settings (controls location, camera, pop-ups, etc.), then allow pop-ups and redirects for account.soloent.ai. Chrome Settings: Privacy and security and Site settings navigation Under Site settings, open Pop-ups and redirects, allow SoloEnt-related sites, and try logging in again.

Can’t find the subscription entry

There are two ways to open the subscription dashboard: Account avatar menu with Dashboard to open the console
  • Option 2 (from v0.3.5): Open in-app Settings (gear) → API Configuration, then click Upgrade subscription under the free model list
API Configuration with Upgrade subscription below the free model list In the web console, open the Subscription Plan tab and pick Lite, Pro, or Max and monthly or yearly billing. Subscription Plan tab in the dashboard to choose plan and billing cycle

Can I cancel and get a refund? What if I run out of quota?

In the dashboard, the active plan shows Cancel subscription. Confirm to cancel.
  • Cancellations do not refund the current period. Benefits last until the end of the cycle; auto-renew stops
  • If your plan quota is exhausted, you can upgrade to a higher tier. Extra top-ups are not supported yet
See Manage subscription. Web dashboard showing Cancel subscription for the active plan

How do I configure a third-party API key

Most third-party providers use OpenAI Compatible—choose it from the API Provider dropdown in settings. You must fill in all three fields:
  • Base URL
  • API Key
  • Model ID
If it still fails, verify these three first. Confirm with your provider before purchase; some services may be unreliable. See API configuration. API Provider dropdown with OpenAI Compatible for third-party setup

Agent doesn’t create files / save files / keeps asking me to save

Check both of the following. 1. Auto-approve
In Agent settings → Auto-approve (or equivalent), whether Edit is allowed to write project files. When on, the Agent can change files directly; when off, you often confirm each write. See Auto-approve.
Auto-approve toggles for read and edit project files 2. Background Edit
Under Settings → Feature Settings (double-checkmark icon on the left), the EDITOR section’s Background Edit controls whether the Agent may edit without stealing editor focus. Turn it off if you want to review every change yourself first.
Feature Settings: Background Edit under the Editor section

Git install prompt (and checkpoints)

You may see: Git must be installed to use checkpoints. If you don’t need checkpoints or rolling back conversation nodes, you can ignore this—it does not block normal writing. Git powers checkpoints and rollback. macOS often includes Git; on Windows install from git-scm.com. SoloEnt panel banner about Git and checkpoints

Why doesn’t my project auto-generate SOLOENT.md anymore

Starting from v0.2.0, SOLOENT.md is no longer created automatically. Use /init whenever you want, at any project stage; short projects that don’t need cross-session context can skip it. See the SOLOENT.md guide.