macOS via Homebrew

<p align="center">
  <img src="./resources/sudowork-banner-1.png" alt="Sudowork - Cowork with AI Agents" width="100%">
</p>

<p align="center">
  <img src="https://img.shields.io/github/v/release/sudoprivacy/sudowork?style=flat-square&color=32CD32" alt="Version">
  &nbsp;
  <img src="https://img.shields.io/badge/license-Apache--2.0-32CD32?style=flat-square&logo=apache&logoColor=white" alt="License">
  &nbsp;
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-6C757D?style=flat-square&logo=linux&logoColor=white" alt="Platform">
</p>

<!-- <p align="center">
  <a href="https://trendshift.io/repositories/15423" target="_blank">
    <img src="https://trendshift.io/api/badge/repositories/15423" alt="GitHub Trending" height="80">
  </a>
</p> -->

---

<p align="center">
  <strong>A free, open-source, Cowork app with AI Agents</strong><br>
  <em>Built-in Agent | Zero Setup | Any API Key | Multi-Agents | Remote Access | Cross-Platform | 24/7 Automation</em>
</p>

<p align="center">
  <a href="https://github.com/sudoprivacy/sudowork/releases">
    <img src="https://img.shields.io/badge/⬇️%20Download%20Now-Latest%20Release-32CD32?style=for-the-badge&logo=github&logoColor=white" alt="Download Latest Release" height="50">
  </a>
</p>

<p align="center">
  <strong>English</strong> | <a href="./readme_ch.md">简体中文</a> | <a href="./readme_tw.md">繁體中文</a> | <a href="./readme_jp.md">日本語</a> | <a href="./readme_ko.md">한국어</a> | <a href="./readme_es.md">Español</a> | <a href="./readme_pt.md">Português</a> | <a href="./readme_tr.md">Türkçe</a> | <a href="https://www.sudowork.com" target="_blank">Official Website</a>
</p>

<p align="center">
  <strong>💬 Community:</strong> <a href="./resources/wechat_group4.png" target="_blank">微信 (中文群)</a> | <a href="https://twitter.com/Sudowork" target="_blank">Twitter</a>
</p>

---

## 📋 Quick Navigation

<p align="center">

[✨ Cowork in Action](#-cowork-in-action) ·
[🤔 Why Choose Sudowork?](#-why-choose-sudowork-over-claude-cowork) ·
[🚀 Quick Start](#-quick-start) ·
[💬 Community](#-community--support)

</p>

---

## Cowork — AI Agents That Work Alongside You

**Sudowork is more than a chat client.** It's a Cowork platform where AI agents work alongside you on your computer — reading files, writing code, browsing the web, and automating tasks. You see everything the agent does, and you're always in control.

|                                 | Traditional AI Chat Clients | **Sudowork (Cowork)**                                                                          |
| :------------------------------ | :-------------------------- | :------------------------------------------------------------------------------------------- |
| AI can operate on your files    | Limited or No               | **Yes — built-in agent with full file access**                                               |
| AI can execute multi-step tasks | Limited                     | **Yes — autonomous with your approval**                                                      |
| Remote access from phone        | Rarely                      | **WebUI + Telegram / Lark / DingTalk**                                                       |
| Scheduled automation            | No                          | **Cron — 24/7 unattended**                                                                   |
| Multiple AI Agents at once      | No                          | **Claude Code, Codex, OpenClaw, Qwen Code, and 12+ more — auto-detected, unified interface** |
| Price                           | Free / Paid                 | **Free & Open Source**                                                                       |

<p align="center">
  <img src="./resources/offica-ai BANNER-function.png" alt="Sudowork Cowork Platform" width="800">
</p>

---

## Built-in Agent — Install & Go, Zero Configuration

Sudowork ships with a complete AI agent engine. Unlike tools that require you to install CLI agents separately, **Sudowork works the moment you install it**.

- **No CLI tools to install** — the agent engine is built in
- **No complex setup** — sign in with Google or paste any API key
- **Full agent capabilities** — file read/write, web search, image generation, MCP tools
- **Ready-to-use assistants** — 11+ built-in professional assistants (Cowork, PPTX Generator, PDF to PPT, 3D Game, UI/UX Pro Max, and more) ready to use immediately

<p align="center">
  <img src="./resources/build-in agents.png" alt="Built-in Agents" width="800">
</p>

---

## Multi-Agent Mode — Already Have CLI Agents? Bring Them In

If you already use Claude Code, Codex, or Qwen Code, Sudowork auto-detects them and lets you Cowork with all of them — alongside the built-in agent.

**Supported Agents:** Built-in Agent (zero setup) • Claude Code • Codex • Qwen Code • Goose AI • OpenClaw • Augment Code • iFlow CLI • CodeBuddy • Kimi CLI • OpenCode • Factory Droid • GitHub Copilot • Qoder CLI • Mistral Vibe • Nanobot and more

<!-- <p alig

... (truncated)