Questions and answers
Short answers. The details are in How it works, the security page and the project's plan.
What is Crewyard?
A local desktop app that runs and supervises coding agents (Claude Code, Codex, Gemini CLI and OpenCode) across several of your own accounts and API keys.
It proposes a crew for each task, waits for your approval, watches limits and spend, hands work to a backup agent when you allow it, and keeps GitHub under your control.
Which operating systems does it run on?
Crewyard is built and tested on Windows 11. Windows 10 has not been tried.
macOS and Linux builds are listed on the download page when a release includes them. They are newer than the Windows build, so read that release's notes for what is known not to work yet.
What does it cost?
Crewyard itself is open source under the MIT licence. The agents run on your own accounts and API keys, so model usage is billed by your providers.
Estimates, daily caps and per-task caps keep that spend visible: a run stops and asks when it reaches a cap.
Which agents and providers can I use?
Four runners: Claude Code, Codex, OpenCode, and Gemini CLI over the Agent Client Protocol.
Providers come from a catalog built from models.dev: Claude Code can run on Anthropic and on Anthropic-compatible endpoints such as DeepSeek, Kimi, GLM, Qwen and MiniMax, Codex on OpenAI and OpenAI-compatible providers, and OpenCode on every catalog provider.
Why can't I sign in to Claude Code with a claude.ai subscription?
Anthropic's Agent SDK terms say third-party products may not offer claude.ai login or its rate limits without Anthropic's approval. Because Crewyard is made to be shared, Claude profiles always use an Anthropic or Anthropic-compatible API key.
Codex, Gemini CLI and OpenCode sign in through their own login flows, and Crewyard never reads, copies or relays those tokens.
Can Gemini CLI run on my Google AI Pro or Ultra plan?
No. Since 18 June 2026 Gemini CLI no longer serves free, AI Pro or Ultra Google accounts, and its Google sign-in does not work for them. Crewyard keeps that sign-in for Gemini Code Assist Standard or Enterprise accounts only.
With a personal plan, add a paid Gemini API key: Gemini CLI and OpenCode profiles then run models such as Gemini 4 Argon and Gemini 3.8 Flash, billed per use.
Can an agent push or merge on its own?
No. Agents commit locally in their worktree. Pushing, opening a pull request, merging, deleting a worktree and spending past a cap always wait for your click in the app.
Autopilot, when you turn it on for a project, can approve crews of tasks it created within your limits, but it has no tool for any of those outward steps.
What happens when an account hits its limit?
The run pauses at a turn boundary and the task follows its fallback rule: ask you (Manual, the default), propose a target you confirm with one click (Ask), continue on the next standby whose checks pass (Auto), or wait for the same account to reset.
A handoff keeps the same worktree and writes a package the next agent reads first; nothing is pushed.
What do Reported, Estimated and Unknown mean?
Every quota or cost number carries one. Reported means the agent or provider said it through an official channel, Estimated means Crewyard computed it from tokens and the catalog price, and Unknown means there is no trustworthy source.
Unknown is never shown as a percentage.
Why does Windows SmartScreen warn about the installer?
The builds are not code-signed yet, so SmartScreen names an unknown publisher. Choose More info, then Run anyway.
You can check the download against the SHA-256 on the download page first. The certificate for signed builds is still an open decision in the plan.
Does Crewyard update itself?
Not yet. The builds are made without an update feed and never look for updates; install a newer release by hand from the download page.
Signed Windows builds with an update feed are prepared: they check only when you press Check now (or turn on automatic checks), download on your click and install only updates signed by the same publisher.
Where does it keep my data, and what happens when I uninstall?
On Windows the app installs per user to %LOCALAPPDATA%\Programs\crewyard without admin rights, and keeps your projects' settings, profiles and database in %APPDATA%\Crewyard.
Uninstalling leaves that data folder in place; deleting it is your call. A project's own settings live in its .crewyard/project.json, which never holds keys.
What do I need installed?
Git, the GitHub CLI (gh) for the GitHub features, and the agent CLIs you want to use: Claude Code 2.1.312 or newer, Codex 0.147.0 or newer, Gemini CLI 0.25.0 or newer, OpenCode 1.19.5 or 2.2.4.
The Start screen checks them and shows the command to install or update each one. Crewyard copies the command; it never runs it for you.
Something missing? Open an issue on GitHub.