Sudo Interns · الفواعلي
Overprompted. Underpaid.
الكبير يخطّط. والفواعلي يشيلوا الشغل.
A free, open-source macOS workshop for your AI coding crew. Your primary leads, an advisor questions the plan, and the interns do the lifting. Hard hats included. Independent review required.
Download for Mac · Website · العربية · Get started · Contribute · License
Keep working in your usual Codex or Claude Code. Sudo Interns connects an independent advisor and supporting workers through MCP. Your primary agent owns the plan, delegates bounded work, inspects the actual changes, runs checks, and records its decision.
The official app is free and will remain free. No app subscription, paid unlocks, or artificial feature tiers. AI provider accounts, subscriptions, and usage are separate and subject to each provider’s terms. The interns are free; their providers still keep a tab.
Public preview. Apple notarized the direct Mac build. We tested it on the development Mac and ran 165 tests on each architecture in CI. Clean-Mac installation and a signed automatic upgrade still need verification. Release notes · Readiness report.
Two names, one crew
الفواعلي (Fawaly) is our original Egyptian Arabic name. It evokes the workers doing the heavy lifting on a building site. In the coding workshop, those are the assistants who turn the lead agent’s plan into working code. Thanks to Ahmed Nagdy for the original name and the idea behind it.
Sudo Interns is a Unix joke. Pair sudo, the command for running something with elevated privileges, with the interns who get all the tickets. The app gives assistants the project scope you approve and grants them no administrator privileges.
What’s new in 0.7.1
- Your team comes first. The primary agent is told to use the team before changing files. When your advisor policy is Important, the engine refuses the first project delegation of a session until the advisor has been consulted. A failed or busy advisor does not block the work.
- Windows and Linux preview. Installers are available. They are unsigned, so Windows SmartScreen will warn you. See what has and has not been tested.
What’s new in 0.7.0
- Skills. Install curated skills and instruction templates for one project or all local projects. Preview potential overlaps and see what’s installed. Skills guide
- Developer Daily. Browse original developer news, save stories, and prepare a practical brief for your crew. Developer Daily guide
- OpenRouter. Connect in your browser or use your own key, then search and pick a model in the app.
- Guided setup. Connect providers from the app, manage saved assistants in one place, and set your delegation order. New installations default to English, with Arabic available in Settings.
How the team works
flowchart LR
You[You, in Codex or Claude Code] --> Primary[Primary agent: plan and verify]
Primary <-->|Independent advice| Advisor[Advisor]
Primary -->|Bounded assignment| Worker[Worker]
Worker -->|Files and report| Primary
Primary -->|Independent decision and evidence| Workshop[Fawaly workshop]
| Role | Available assistants |
|---|
| Primary | Codex, Claude Code |
| Advisor | Native accounts plus configured API/local assistants |
| Worker | Native accounts plus configured API/local assistants |
An agent has one role in a saved team. A typical team is Codex → Claude advisor + Kimi worker. You can change roles in setup. Primary agents decide when to call tools; integrations cannot guarantee every model will always follow a policy.
Get started
The signed, notarized preview supports macOS 14 or later on Apple Silicon and Intel Macs.
- Download the Mac ZIP, unzip it, and move Sudo Interns to Applications. Open it from there.
- Follow the Arabic or English setup: choose your primary, advisor, and workers.
- Let Fawaly prepare the official supporting tools. Sign in through each provider’s own browser flow. No Terminal commands or pasted setup tokens.
- Connect the team. Fawaly registers MCP in your primary agent’s user settings. Reopen that client or start a new chat if it cached its tools.
- Choose a project folder when you want workers to edit files. Continue your work in your usual primary client.
For substantial tasks, the team instructions ask the primary to consult according to your advisor policy, delegate suitable bounded work, inspect the result independently, and save a review. Native client tool approvals still apply.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
