Help & FAQ

Getting the app

UltraCodey is in open beta on Windows. Create a free account or sign in to download it right away. The app is the full product - chat, code, the engineering firm, research, benchmarking, employees, and Codey - and the Free plan covers all of it during beta. An account is still required to run the app.

How open beta access works

Use the Download flow, or the Beta access card on your dashboard when you are signed in. During open beta, new accounts are approved automatically so you can download immediately.

• Create or sign in - use a free account so the app can verify entitlement.
• Download - once signed in, the installer link is available right away from the download flow and account dashboard.
• Run the app - sign in with the same account on Windows; anonymous use is not entitled.

If open beta later returns to manual review, your dashboard will show the current status and any next steps.

Does UltraCodey work offline?

Mostly, yes. Your code, chats, memory, and provider keys are all local, and with a local model through Ollama the agent itself can run without a connection - the app includes curated model presets grouped by how much VRAM your graphics card has. Cloud providers and account sync need internet, so you will want to be online for the hardest tasks and for your profile to sync. See Offline & local models in the docs.

How do budgets work?

AI requests go straight from your machine to the providers on your own keys or plans, so UltraCodey gives you the controls: a cost dashboard (spend by model, project, and chat with a 30-day chart), a monthly cap and a per-run cap you set in Settings - each can either warn you or pause the run when reached - and a pre-send cost badge in the composer that estimates a message's cost before you send it. Details in Cost control.

What does Auto mode do?

Auto is the hands-off permission mode. Instead of asking you about every action, a deterministic risk table and rule engine approve low-risk actions instantly, a constrained reviewer examines high-risk ones, and every decision is recorded in an audit log you can inspect in the app. You can always drop back to Ask or Plan mode for more control - see Permission modes & safety.

How do I debug my code?

Open a file in the built-in editor, click the gutter to set a breakpoint, and run the debugger - Go and JavaScript/TypeScript are supported, including child processes. The editor also gives you inline language-server diagnostics, go-to-definition (F12), find-all-references (Shift+F12), and project-wide search, and the integrated terminal and Changes view sit alongside it. See Terminal, editor & debugging.

Creating an account and signing in

Create an account with an email and a password (at least 8 characters) either here on the web at the sign-in page or inside the desktop app. It is the same account in both places.

• Google sign-in is available in the desktop app. Web sign-in uses email and password.
• If you registered with Google in the app, set a password via Forgot password to also sign in on the web.
• Repeated failed attempts are rate-limited - if you see "too many attempts", wait a bit and try again.

Account linking and sync

There is nothing to link - signing in on the web and in the desktop app with the same email is the link. The desktop app syncs with your account about every 5 minutes while it runs: XP, usage time, achievements, and profile updates flow up automatically, and anything you change here (like your display name) flows back down.

XP, levels, and achievements

You earn XP by actually using UltraCodey - completed runs, reviews, streaks, and achievements. Levels are unbounded and each one costs a little more than the last (level 1 to 2 takes 120 XP).

• Tiers: every 10 levels is a new badge tier - Sprout, Bronze, Silver, Gold, Platinum, Diamond, Master, Grandmaster, Legend, Mythic, and Ultra at level 100.
• Prestige: past level 100 you earn a prestige star every 10 levels.
• Achievements unlock in the desktop app across every section and sync to your account, so the dashboard here always shows your latest unlocks.
• Levels also unlock Codey characters and themes in the app.

Two-factor authentication (2FA)

2FA adds a second step at sign-in: a 6-digit code from an authenticator app on top of your password. Turn it on from the Security card on your dashboard.

• Setup: click Enable two-factor, scan the QR code with any authenticator app (Google Authenticator, 1Password, Authy, Microsoft Authenticator...) or enter the secret manually, then confirm with the 6-digit code the app shows.
• Recovery codes: when 2FA turns on you get 10 one-time recovery codes. They are shown only once - copy or download them and keep them somewhere safe (a password manager is ideal).
• Lost your device? At the sign-in code prompt choose Use a recovery code instead and enter one of your saved codes. Each code works once. Once in, you can disable and re-enable 2FA to enroll a new device.
• Lost the device and the recovery codes? Email support@ultracodey.com from your account email and we will verify you manually.
• Entering the wrong code too many times (or waiting more than a few minutes) ends that sign-in attempt - just sign in again with your password to get a fresh code prompt.

Sessions

A session is one place where your account is signed in - this browser, another browser, or the desktop app. The Security card on your dashboard lists every active session with its client, IP address, and when it was last used.

• Sign out one: click Sign out next to the session. If it is the session this browser is using, you will be signed out here too.
• Sign out everywhere else: ends every session except the one you are using - do this if you see anything you do not recognize, then change your password.
• Changing your password automatically signs out every other session.

Devices and sign-in history

The dashboard shows every device that has used your account (including this browser and your desktop app) and your recent sign-ins with time, approximate location, and whether the attempt succeeded. This is security visibility for you: if you see a sign-in you do not recognize, change your password right away from the Security card - that signs out every other session - and consider turning on two-factor authentication.

Messages from the team

Important notices - beta updates, account notes, security heads-ups - arrive in the Messages inbox on your dashboard and inside the desktop app. Severity is color-coded (info, warning, critical). Clicking an unread message marks it read everywhere.

Banned or paused accounts

If your account is paused, access is temporarily suspended; if it is banned, it has been closed. In both cases the portal shows the reason when one was given. To appeal, email support@ultracodey.com from your account email with a short description of what happened. We read every appeal.

Password reset

Use Forgot password on the sign-in page. If the email matches an account, a reset link is sent; the link opens a page where you choose a new password and are signed in immediately. For security, the response is the same whether or not the email exists, and reset links expire.

Privacy: what your account stores

Your UltraCodey account stores only what the portal shows you:

• Profile: email, display name, plan, beta status.
• Progression: XP, usage time, achievements.
• Security metadata: devices and sign-in records (time, IP-derived city/country, client).
• Messages from the team.

Your secrets and project work are not uploaded to Pegasus Vision account systems. Provider keys, OAuth tokens, code, chats, memory, and project data stay local to your machine and are not part of account sync. If you authorize AI-provider or plugin work, relevant prompts, file snippets, or context may be sent directly from your device to the provider or integration you choose.

Contact

Email support@ultracodey.com for support, beta access, appeals, or anything else - or reach out on X at @UltraCodey.