UltraCodey documentation

Overview

UltraCodey is built to bring the whole build loop into one clean app: you give it an outcome, and it can organize the job, keep context attached, edit files, run commands, check its work, and show the verification signal before the task is treated as done. Alongside coding it can monitor topics, benchmark models, and run scheduled work for you.

It is local-first: your code, chats, project files, saved patterns, and provider credentials are not uploaded to Pegasus Vision account systems. When you ask UltraCodey to use an AI provider or integration, the relevant prompts, file snippets, or context may be sent directly from your device to the provider you choose. When enabled, UltraCodey account sync stores the categories described under Privacy & your data.

Open beta access

Create a free account or sign in from the Download or Get the app flow. During open beta, new accounts are approved automatically so you can download immediately. An account is still required to run the Windows app.

• Create or sign in - use a free account so UltraCodey can verify entitlement.
• Download - once signed in, the installer link is available from the download flow and your 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.

Install & first launch

After you create or sign in to your account, use the download flow or dashboard link to install UltraCodey on Windows. On first launch, sign in with the same account, then open a project folder. The first time you open a folder, UltraCodey takes a moment to get oriented before it starts working so its plans match your project.

You stay in control throughout: choose how much autonomy to grant (from asking before each action, to planning first, to working hands-off), and you can steer at any time while it runs.

Sign in & your account

One account works everywhere. Create it with an email and a password (at least 8 characters) on the web sign-in page or inside the desktop app - it's 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, set a password with 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.

The workspace

UltraCodey is organized into focused areas you switch between from the top of the window:

• Chat - a general assistant for quick questions and planning.
• Code - the engineering workspace where the agent plans, edits, runs, and verifies.
• Research - standing loops that watch topics and turn findings into action.
• Benchmark - compare models on real tasks by speed, cost, and quality.
• Employees - focused AI workers you assign recurring duties to.

Supporting systems - memory, skills, plugins, automations, and performance tweaks - are built in, and Codey rides along as an optional companion.

The right-side workspace

In the Code section, workspace tabs open beside the chat and stay alive while you work:

• Terminal - a real shell with multiple sessions. A live session survives switching tabs or sections.
• Editor - a full code editor with syntax highlighting, diagnostics, and project search (see Terminal, editor & debugging).
• Browser - a built-in web view with back/forward history the agent can also drive.
• Changes - red/green diffs of everything modified in your working tree, with review tools.

Getting around

• Command palette - press Ctrl+K to run any command; Ctrl+P opens the quick file picker and search.
• Back and forward - the title bar has browser-style navigation across sections; Alt+←/Alt+→ and the extra buttons on a standard mouse work too.
• Themes - choose from dark, light, midnight, nord, solarized (dark and light), dracula, and high-contrast in Settings.

Permission modes & safety

You choose the autonomy level. Every run operates under a permission mode you can change at any time, and several safety nets sit underneath all of them.

Full Access

The agent edits files and runs commands without stopping to ask. Best when you trust the task and want speed.

Ask

The agent requests approval before actions that change things - you see each edit or command and approve or deny it.

Plan

The agent plans first and does not touch anything until you review and approve the plan.

Auto

A hands-off auto-reviewer: a deterministic risk table and rule engine decide low-risk actions instantly, a constrained reviewer examines high-risk calls, and every decision is written to an audit log you can inspect in the Audit view.

Safety nets

• Checkpoints and /revert - the workspace is checkpointed as the agent works, so you can roll back to any earlier point in one step.
• Auto-backup - before the agent edits a file, a snapshot is saved to .ultracode/backups/ in your project (toggleable in Settings).
• Process containment - on Windows, agent-launched processes can run inside a Job Object (opt-in), so ending a run cleans up the whole child process tree.
• Command validation - destructive commands against protected paths are caught before they run, including obfuscated and chained variants.

Slash commands & goals

Slash commands work from the composer in any Code chat. The most important one is /goal: give UltraCodey an outcome and it keeps planning, building, testing, and fixing until the goal is verifiably complete - not just until the first reply.

• Mid-run steering - type while the agent works; your message is picked up on the next turn without stopping the run.
• Todo checklist - longer tasks show a live checklist so you can see the plan and watch items complete.

Coding & review

Give UltraCodey a goal and, depending on your permissions and project setup, it can plan the change, edit files, run commands, read the output, catch mistakes, check the diff, run tests, and surface verification before calling the job done. Checkpoints let you revert if you want to roll back.

For serious changes you can use the engineering-firm workflow, which separates responsibility the way a real software shop does:

Engineer

Turns the goal into a plan, delegates the work, reviews the returned diff, and sends precise markups back when it isn't good enough.

Designer

Implements the assigned work with the full tool set and hands it back for review.

Principal

Reviews the actual changes against the latest test results and either approves or returns numbered markups.

Security

Runs a final adversarial pass. If it flags real risk, the work does not ship.

The built-in reviewer also catches regressions, risky edits, missing tests, and weak proof.

Terminal, editor & debugging

Integrated terminal

A real terminal (not a command log) runs inside the workspace. You can open multiple sessions, copy and paste, and keep a live shell running while you switch tabs or sections - the session survives navigation.

Code editor

• Syntax highlighting with a proper gutter, plus Ctrl+S to save, Ctrl+F to find, and Ctrl+W to close a tab.
• Inline diagnostics - language-server errors and warnings appear as you type, with F12 go-to-definition and Shift+F12 find-all-references.
• Project-wide search - search file contents across the whole project from the Search tab.
• File tree - create, rename, and delete files and folders, with live refresh as the agent works.

Debugging

Set breakpoints from the editor gutter and debug Go and JavaScript/TypeScript programs with step, inspect, and child-session support.

Changes & diffs

The Changes view shows red/green diffs of everything modified in your working tree, with side-by-side comparison and a built-in code reviewer, whether or not the project uses git (checkpoint-backed otherwise).

Computer use & the browser

Beyond your project, UltraCodey can operate your own desktop when you allow it: take a screenshot, move and click the mouse, type, list open windows, and launch applications. That lets it verify UI work by actually looking at the screen, or drive an app the way you would.

There is also a built-in browser view the agent can open and navigate - useful for reading docs, checking a local dev server, or verifying a deployed page without leaving the app.

Research & benchmark

Research

Set up standing research loops to track competitors, libraries, markets, news, products, or any custom topic. UltraCodey gathers and synthesizes what's new on a schedule and can turn the findings into tasks without switching tools.

Benchmark

Compare AI models on tasks that matter to you. Benchmark reports show speed, latency, cost, output quality, and fit, so you can pick the right model by evidence instead of hype.

Employees & automation

Assign repeat work to focused AI employees - QA, docs, release checks, monitoring, research, audits, and the daily jobs that shouldn't wait on you. Standing duties run on a schedule; one-off assignments run on demand. Automations let you schedule any recurring agent run.

Memory, skills & plugins

• Memory - UltraCodey remembers useful patterns and decisions and carries that context forward across chats and projects, so it gets more useful the longer you work together.
• Skills - reusable playbooks the app can build from real sessions and apply later.
• Plugins - one-click integrations you connect to extend what the app can do, with secure sign-in where a service requires it.
• Import - bring knowledge, skills, and integration settings over from other tools you already use.

Codey companion

Codey is an optional on-screen companion connected to the same workspace. It offers screen-aware help, voice and talk-back, reminders, reviews, and notifications. There's a playful layer too - characters, themes, and leveling that unlock as you use the app - and you can turn any of it on or off.

Accounts & sync

There's nothing to link: signing in on the web and in the desktop app with the same email is the link. While the desktop app runs, it checks in with your account about every five minutes - selected memory, skill and automation metadata, permission rules, non-secret settings, XP, usage time, achievements, and profile updates can flow between devices. You can turn cloud sync off from the Account view without disabling sign-in, entitlement, billing, or security checks.

Security

Your account includes security controls and visibility, all on the Security card of your dashboard:

• Two-factor authentication (2FA) - add a 6-digit authenticator code at sign-in. Turning it on gives you ten one-time recovery codes, shown only once, so save them somewhere safe.
• Sessions - see everywhere your account is signed in, sign out a single session, or sign out everywhere else.
• Password - changing your password automatically signs out every other session.
• Devices & sign-in history - review the devices that have used your account and recent sign-ins, including approximate location and whether each attempt succeeded.

Connections are encrypted in transit and passwords are stored only as salted hashes - never in plain text. If you see a sign-in you don't recognize, change your password right away.

Plans & billing

The Free plan keeps the core app available at no charge. Pro is $5/month and unlocks premium themes, characters, Ultra features, and the production feature set as it rolls out.

You can review your current plan on the Subscription page. Paid billing is governed by the Terms of Service and Refund Policy will govern billing.

Privacy & your data

Your UltraCodey account and optional connected features can store:

• Profile: email, display name, plan, and beta status.
• Progression: XP, usage time, and achievements.
• Security metadata: devices and sign-in records (time, IP-derived city/country, client).
• Messages from the team.
• When cloud sync is on: selected memory content, skill and automation metadata, permission rules, and non-secret app settings.
• When you enable them: companion run events, email-relay mailbox and message content, explicit share content, and temporary voice-relay media.

Your secrets and project work are not uploaded to Pegasus Vision account systems. Provider API keys, notification credentials, sign-in tokens for AI services, source code, project files, and ordinary full chats stay local to your machine and are not part of account sync. When 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. For the full details, read the Privacy Policy.

Providers & API keys

UltraCodey ships with 20 built-in providers: Anthropic, OpenAI, Google Gemini, OpenRouter, xAI, DeepSeek, Mistral, Groq, Ollama, MiniMax, Moonshot/Kimi, Zhipu/GLM, Qwen, Together, Fireworks, Cerebras, Perplexity, Nebius, DeepInfra, and Hyperbolic. You can also add any custom OpenAI-compatible endpoint (base URL plus key).

Two ways to connect

• API keys - paste a key in Settings; it is validated against the provider before it's accepted and stored in the Windows credential manager.
• Sign in with your plan - Anthropic (Claude Pro/Max) and OpenAI (ChatGPT Plus/Pro via the Codex flow) support signing in with your existing paid subscription instead of a key.

Ultra model fusion & roles

• Ultra fusion - one toggle uses all of your connected models together: the strongest one orchestrates the run, and sub-tasks collapse to the strongest concrete model rather than fanning out wastefully.
• Orchestrator and worker roles - pick one model to manage and a different model (or Auto) to do the work, so you can use multiple subscriptions at once.

Cost control

Because requests go straight to providers on your own keys or plans, UltraCodey gives you the tooling to see and cap what you spend:

• Cost dashboard - spend broken down by model, project, and chat, with a 30-day chart and per-run totals.
• Budgets - set a monthly cap and a per-run cap in Settings, and choose whether hitting one warns you or pauses the run.
• Pre-send cost badge - the composer shows an estimated cost for your message before you send it.

Plan sign-ins (Claude Pro/Max, ChatGPT) bill through those subscriptions rather than per-token, and local models cost nothing to run.

Offline & local models

UltraCodey integrates with Ollama for fully local models: check status, pull models with progress, and manage them from Settings → Providers. Curated presets are grouped by VRAM tier, so you can pick a model that actually fits your graphics card instead of guessing.

Local models make sense when you want zero per-token cost, when code must not leave your machine, or when you're offline. Cloud models still lead on the hardest agentic work, so many people mix the two - a local model for quick tasks, a frontier model for the big ones. An internet connection is still needed for account sync.

Auto Tweak (Windows performance)

Auto Tweak is a one-click Windows performance optimizer built into the app. It probes your system's current settings, shows current-versus-optimal for each documented tweak (power plan, scheduling, GPU, memory, services, visual effects), and applies the ones you select.

• Tiers - tweaks are grouped as Safe, Recommended, and Expert; pick a tier or individual items.
• Full revert - before the first apply, your original values are snapshotted; "Revert all" restores exactly what you had, not generic defaults.
• One UAC prompt - tweaks that need administrator rights are batched into a single elevated run, and declining is handled gracefully.
• Honest results - success is judged by re-probing the setting, not by assuming the change worked.

Keyboard shortcuts

Shortcuts are rebindable in Settings.

System requirements

• A Windows desktop or laptop (UltraCodey is in open beta on Windows).
• Access to at least one supported AI provider - your own account/key, or a local model.
• An internet connection for account sync and provider requests.

Troubleshooting

The app won't start after install

Windows SmartScreen or an antivirus may flag a newly released build. If SmartScreen shows "Windows protected your PC", choose More info → Run anyway. If an antivirus quarantined the app, restore it and add an exclusion, or reinstall from the download page.

Sign-in loop or "session expired"

Sign out inside the app, then sign back in. If it persists, check the Security card on your dashboard - your account may have had all sessions signed out (for example after a password change) - and make sure your system clock is roughly correct.

Provider key rejected (401/403)

Keys are verified against the provider when you save them. A 401 means the key is wrong or revoked; a 403 usually means the key lacks access to the model you picked or the provider account has a billing issue. Generate a fresh key in the provider's console and re-enter it in Settings → Providers.

Updater seems stuck

The installer build updates in place; the portable build cannot self-update - download the new portable exe from the download page and replace the old one. If an installer update stalls, close the app fully and relaunch, then check for updates again.

Where are the logs?

Local logs live in %APPDATA%/UltraCodey/logs. Attach the most recent file when you email support - it contains no provider keys or secrets.

How do I fully reset?

Sign out in the app, uninstall, then reinstall and sign back in. Your cloud profile (XP, achievements, plan, messages) is kept on your account; local data such as chats, memory, and provider keys lives in %APPDATA%/UltraCodey - delete that folder only if you also want a clean local slate.

FAQ

The Help & FAQ page answers the common questions in detail - getting the app, accounts and sync, XP and achievements, two-factor authentication, sessions, messages, password reset, appeals, and privacy. A few quick ones:

Is it really free right now?

Yes - the Free plan covers the full app during beta.

Do my code and chats get uploaded?

They are not uploaded to Pegasus Vision account systems. 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.

I forgot my password.

Use Forgot password on the sign-in page.

My account is paused or banned.

See appeals and email us from your account address.

Support

Email support@ultracodey.com for support, beta access, appeals, or anything else - or reach out on X at @UltraCodey. For account and security questions, the Help page is the fastest reference.