Help

How Yokera for Mac works, in short.

First steps

Not available to download yet.

Yokera runs on macOS 13.5 or later, on Apple silicon and Intel.

The first time it opens, it asks you to connect your first model, whether to show your existing Claude Code and Codex chats (off unless you turn it on) and which project folder to work in. Then send a first message.

Skipped it? Get started, on Home, has Connect a model.

Accounts

Settings › Accounts lists every provider, each with one button to connect it.

  • Claude: Claude Code — signed in with your Claude account (Anthropic’s own sign-in). Yokera runs Claude Code, Anthropic’s command-line tool, which must be installed on your Mac; its own sign-in opens in a terminal tab, and Yokera never sees your password. If it is missing, Settings › Accounts says so and links to Anthropic’s install page.
  • ChatGPT: Codex chats use your OpenAI API key. To use your ChatGPT plan, run Codex in a Yokera terminal tab. Yokera runs Codex, OpenAI’s command-line tool, which must be installed on your Mac. If it is missing, Settings › Accounts says so and links to OpenAI’s install page.
  • Google, in preview: sign in with your Google AI plan. When you add it, Yokera downloads Google’s own Antigravity agent and you sign in with Google in your browser.
  • Cursor, in preview: sign in with your Cursor plan.
  • API keys: Grok, DeepSeek, Kimi, Mistral and other providers connect with your own API key, which the provider charges per use. Claude, ChatGPT and Google take one too.
  • Local models: models that run on your Mac, through a model server on it.

Usage counts against your own plan or API key; provider terms and limits apply and can change.

With more than one account of a provider, a chat’s Account menu chooses which one it uses. When an account reaches its limit, the chat tells you and you choose what to do.

Permissions

Each chat has its own access, which you change under its message box. New chats start in Ask first; Settings › Permissions changes the default.

  • Read only: only reads and searches; asks before visiting a site.
  • Ask first: reads by itself; asks before every edit, every command that changes something and visiting a site.
  • Accept edits: reads and edits by itself; asks before commands and visiting a site. With GPT in Codex, commands that stay in the chat’s folder run without asking.
  • Full access: does everything by itself, its sub-agents too.

When a chat asks, you answer on its card: Allow once or Deny, and often Allow for this chat or Always allow. Settings › Permissions lists the Always allow rules you saved; remove one there at any time.

In every access, a sub-agent that would use one of your paid API keys asks you first, and Yokera’s own files stay protected: a chat never writes its database and never reads its API token or its master key.

Cursor and the other coding agents in preview keep their own rules, listed in Settings › Sub‑agents › Coding agents.

Your chats

At the top of the chat list, Needs you holds the chats that wait for something only you can do: an approval, a question or a reply that stopped. Working holds the chats at work now, and Finished the replies of the last 24 hours that you have not opened.

The Dashboard puts on one page what needs you, what is working and what is left of your plans.

Review and undo

A reply that changed files ends with how many, as in 3 files changed: choose it to open the Diff panel and read each change line by line, in one column or side by side.

Undo, beside it, lists the files of that reply and, once you confirm, puts each one back as it was before the reply. A file that changed again since then is left as it is, and Undo says so.

Plans and usage

Settings › Usage shows the limits of your Claude plans, account by account: what is left and when it resets. On the same page you can ask for an alert before a limit runs out.

On the Dashboard, Usage names the account your chats use now and what it has left.

Sub-agents and Ultracode

A chat can hand parts of the work to sub-agents on other models, and you see which one runs each part. Settings › Sub‑agents chooses their models and their limits.

Ultracode, in the reasoning menu of the models that offer it, is long, multi-agent work for big tasks. While it is on, a Sub-agents row under it sets the reasoning level of its sub-agents.

Keyboard

⌘K finds projects, chats and actions, ⌘N starts a new chat, ⌘F finds words in the open chat and ⌘/ opens the model menu.

In the app, Help (?) › Keyboard shortcuts lists them all, and you can change any of them there.

Remote access

Yokera runs on your Mac; out of the box, no other device can reach it.

Subscription

Yokera is a monthly subscription in three packages: Solo is $20 a month for 1 Mac, Studio $50 a month for up to 3 Macs and Regia, and Fleet $100 a month for up to 5 Macs, priority support and new features first. Plus tax where it applies.

  • Subscribe: in Yokera, choose a package and pay on Stripe’s page in your browser. The Mac unlocks by itself when the payment is done, and your licence key arrives by e-mail.
  • Another Mac: in Settings › Plan & billing, Get a key for another Mac gives a new key; on the other Mac, choose Use your licence key and paste it. A package covers 1, 3 or 5 Macs.
  • Your team: the Macs can be yours or your team’s. Each person signs in with their own provider accounts; a provider plan is never shared between people.
  • Moving Macs: remove a Mac in Settings › Plan & billing, or choose Use this Mac instead on the new one. A licence moves at most 3 times in 30 days.
  • Changing package: a bigger package starts at once and you pay the difference for the rest of the month; a smaller one starts at your next renewal.
  • More Macs than a package covers: after a move to a smaller package, you have 7 days to remove the Macs you no longer use; then the Macs used most recently keep it. The Mac you are using is never stopped at the change.
  • Offline: the app checks your subscription about every 3 days. Offline, it keeps working for 21 days, and in the last 7 it says so.
  • Cancel: from any browser, on the Manage billing page. Your package keeps working to the end of the month you paid for, and your chats stay on your Mac.
  • Refunds: money back within 14 days of your first payment: every payment made in those 14 days, a package change included. A move to a bigger package: on request within 14 days of that payment, the difference back and the package as before, once per customer.
  • When a provider changes: Claude-plan chats and Regia use Claude Code’s -p mode, which Anthropic has said will change; if your plan stops working there, you get that month back. Ask within 30 days of our notice.
  • Withdrawal: in the EU and the UK, within 14 days of your first payment, choose Withdraw from contract here in Settings › Plan & billing or on the withdrawal page, then Confirm withdrawal.
  • Priority support: Fleet’s messages are answered before others’. Every package gets support by e-mail.
  • New features first: when we add a feature to the packages, Fleet gets it 14 days before the other packages that include it. Updates for everyone reach every package the same day.
  • What the check sends: a random installation id, the public half of a key made on your Mac, a hashed hardware id, the Mac’s model, the app version and the licence. Never your chats, projects, files, accounts or keys.

Privacy

  • Chats, projects, history and settings are saved on the Mac that runs Yokera.
  • A request to a model goes from your Mac to the provider you connected, under its terms.
  • The microphone is used only while you dictate a message or give a voice command, after macOS asks for your permission. Your speech becomes text on your Mac or through a provider you connected; recordings are not sent to us.
  • Yokera has no analytics or crash reporting of its own.

The privacy page says more, and how to reach us.

Remove Yokera

In Yokera, Settings › About › Remove Yokera copies the line; the same line is under Remove Yokera on the home page, beside the install line. Quit Yokera, then paste it in Terminal. It moves the app to the Trash and stops its service; your chats and settings stay on this Mac.

Terminal then shows where your chats and settings are kept; move that folder to the Trash to delete them too.