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

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗