Crewyard
Run crews of coding agents from one desktop app, on your own accounts and keys.
Website · Download · How it works · Changelog · Releases
A local desktop app that runs and supervises coding agents (Claude Code, Codex, Gemini CLI, OpenCode) across several of your own accounts and API keys. You write a goal; Crewyard plans it into tasks, proposes a crew for each, and runs nothing until you approve. It watches limits and spend, hands work to a backup agent when you allow it, and keeps every push, pull request and merge behind your click.
License: MIT · Contributing · Security policy
Status: v0.2.0, the first public release. It is built and tested on Windows 11, and each release also ships for macOS (Apple silicon and Intel) and Linux (x64). Those packages are built and started on GitHub's runners for every release, but have not been tried on real Macs or Linux desktops yet (ADR 0010). No build carries a publisher's signature yet (macOS builds are only ad-hoc signed), and none checks for updates (PLAN.md §17).
Install
Download from the website, which picks the file for your system, or from this repository's Releases. Each release lists SHA256SUMS.txt for checking a download.
| System | File | First start |
|---|
| Windows 11, x64 | Crewyard-Setup-<version>-x64.exe: installs for your user, no admin prompt | SmartScreen: More info, then Run anyway |
| macOS 13 (Ventura) or later, Apple silicon | Crewyard-<version>-arm64.dmg (or -arm64-mac.zip) | not notarized: System Settings → Privacy & Security → Open Anyway |
| macOS 13 (Ventura) or later, Intel | Crewyard-<version>-x64.dmg (or -x64-mac.zip) | as above |
| Debian, Ubuntu (x64) | crewyard_<version>_amd64.deb: sudo apt install ./crewyard_<version>_amd64.deb | from the app menu, or crewyard |
| Other Linux (x64) | Crewyard-<version>-x86_64.AppImage: chmod +x, then run it | needs FUSE 2 (libfuse2) |
- Linux packages need glibc 2.35 or newer: Ubuntu 22.04, Debian 12, Fedora 36 and later.
- On Ubuntu 24.04 and later, prefer the deb. It installs the AppArmor profile Chromium's sandbox needs; the AppImage runs there without that sandbox.
- macOS from the terminal instead of Open Anyway:
xattr -dr com.apple.quarantine /Applications/Crewyard.app.
- These builds do not update themselves; install the next release over the old one. Your data stays in
%APPDATA%\Crewyard, ~/Library/Application Support/Crewyard or ~/.config/Crewyard.
The same steps are at the top of every release's notes (docs/release-notes/install.md). How a release is cut is in docs/release.md.
Website
crewyard-two.vercel.app is the project's website: what Crewyard is, how it works, downloads for Windows, macOS and Linux with their checksums, the changelog, the FAQ and the security model. Its source is apps/web, a Next.js app on Vercel. It reads releases from this repository's GitHub releases, so each new release appears on the download and changelog pages within the hour with no code change; apps/web/README.md covers development, the screenshots, the deploy and its environment variables.
Screens
All screenshots use the app's sample data.
| Crew graph | Inbox | Limits and usage |
|---|
| | |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
