Documentation
UltraCodey documentation
UltraCodey is a desktop workspace that plans the work, writes the code, reviews the diff, runs research, compares models, and automates the repeat jobs — with Codey beside you. This guide covers getting started, the day-to-day workflow, and how your account, security, and data work.
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 Emulation 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. Your UltraCodey account syncs only your profile and progression (see Privacy & your data).
Availability. UltraCodey is in private beta on Windows. The Free plan covers the full app during beta — see Request beta access.
Request beta access
There are two ways to request access:
- The Download or Get the app flow, which sends you to sign in or create an account.
- The Beta access card on your dashboard when you are signed in.
Your request moves through three states:
- Pending
- We have your request and are reviewing it. Nothing else to do.
- Approved
- You're in. We email the download link, and it also appears in your dashboard messages.
- Not approved
- You can request again. A short note about what you want to build helps.
If you request with the same email you use for your account, the approval attaches to your account automatically and your dashboard status updates.
Install & first launch
Once you're approved, use the download link from your email or dashboard to install UltraCodey on Windows. On first launch, sign in or create an 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.
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.
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 — your XP, usage time, achievements, and profile updates flow up automatically, and changes you make here (like your display name) flow back down.
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
During the private beta, the Free plan gives you access to everything at no charge. Ultra — which also includes access to everything — is planned for when the beta ends, but it is not yet on sale, and nothing on the site will charge you today.
You can review your current plan on the Subscription page. When paid plans launch, the Terms of Service and Refund Policy will govern billing.
Privacy & your data
Your UltraCodey account stores only what the portal shows you:
- 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.
Your secrets and project work are not uploaded to Emulation account systems. Provider API keys, sign-in tokens for AI services, your code, chats, memory, and project data 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 works with the major AI providers. Connect them with your own API key, or sign in with an existing paid plan where that's supported. You can also point it at OpenAI-compatible endpoints or run local models.
Your keys stay yours. Provider credentials are stored locally on your device and are not uploaded to UltraCodey. Requests to AI providers go directly from your machine using your own account or key, and may include the prompts, file snippets, or context needed for the work you request — including any usage charges those providers bill.
System requirements
- A Windows desktop or laptop (UltraCodey is in private 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.
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 the private beta.
- Do my code and chats get uploaded?
- They are not uploaded to Emulation 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 ultracodey@gmail.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.