126 lines
5.1 KiB
Markdown
126 lines
5.1 KiB
Markdown
<p align="center">
|
|
<img src="resources/icons/png/1024x1024.png" alt="Claude Agent Teams UI" width="120" />
|
|
</p>
|
|
|
|
<h1 align="center">Claude Agent Teams UI</h1>
|
|
|
|
<p align="center">
|
|
<strong><code>You're the CTO, agents are your team. They handle tasks themselves, message each other, review each other's code. You just look at the kanban board and drink coffee.</code></strong>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest"><img src="https://img.shields.io/github/v/release/777genius/claude_agent_teams_ui?style=flat-square&label=version&color=blue" alt="Latest Release" /></a>
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/actions/workflows/ci.yml"><img src="https://github.com/777genius/claude_agent_teams_ui/actions/workflows/ci.yml/badge.svg" alt="CI Status" /></a>
|
|
</p>
|
|
|
|
<br />
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-arm64.dmg">
|
|
<img src="https://img.shields.io/badge/macOS-Download-black?logo=apple&logoColor=white&style=flat" alt="Download for macOS" height="30" />
|
|
</a>
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI.AppImage">
|
|
<img src="https://img.shields.io/badge/Linux-Download-FCC624?logo=linux&logoColor=black&style=flat" alt="Download for Linux" height="30" />
|
|
</a>
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-Setup.exe">
|
|
<img src="https://img.shields.io/badge/Windows-Download-0078D4?logo=windows&logoColor=white&style=flat" alt="Download for Windows" height="30" />
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<sub>100% free, open source. No API keys. No configuration.</sub>
|
|
</p>
|
|
|
|
<br />
|
|
|
|
<!--
|
|
<p align="center">
|
|
<video src="https://github.com/user-attachments/assets/2b420b2c-c4af-4d10-a679-c83269f8ee99">
|
|
Your browser does not support the video tag.
|
|
</video>
|
|
</p>
|
|
|
|
---
|
|
-->
|
|
|
|
## Installation
|
|
|
|
### Requirements
|
|
|
|
None. Claude Code is **not required** to be installed beforehand — the app includes a built-in installer and login, so you can set up everything directly from the app.
|
|
|
|
### Direct Download
|
|
|
|
| Platform | Download | Notes |
|
|
|----------|----------|-------|
|
|
| **macOS** (Apple Silicon) | [`.dmg`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-arm64.dmg) | Drag to Applications. On first launch: right-click → Open |
|
|
| **macOS** (Intel) | [`.dmg`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-x64.dmg) | Drag to Applications. On first launch: right-click → Open |
|
|
| **Linux** | [`.AppImage`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI.AppImage) / [`.deb`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-amd64.deb) / [`.rpm`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-x86_64.rpm) / [`.pacman`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI.pacman) | Choose the package format for your distro |
|
|
| **Windows** | [`.exe`](https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-Setup.exe) | Standard installer. May trigger SmartScreen — click "More info" → "Run anyway" |
|
|
|
|
|
|
---
|
|
|
|
## Development
|
|
|
|
<details>
|
|
<summary><strong>Build from source</strong></summary>
|
|
|
|
<br />
|
|
|
|
**Prerequisites:** Node.js 20+, pnpm 10+
|
|
|
|
```bash
|
|
git clone https://github.com/777genius/claude_agent_teams_ui.git
|
|
cd claude_agent_teams_ui
|
|
pnpm install
|
|
pnpm dev
|
|
```
|
|
|
|
The app auto-discovers your Claude Code projects from `~/.claude/`.
|
|
|
|
#### Build for Distribution
|
|
|
|
```bash
|
|
pnpm dist:mac:arm64 # macOS Apple Silicon (.dmg)
|
|
pnpm dist:mac:x64 # macOS Intel (.dmg)
|
|
pnpm dist:win # Windows (.exe)
|
|
pnpm dist:linux # Linux (AppImage/.deb/.rpm/.pacman)
|
|
pnpm dist # macOS + Windows + Linux
|
|
```
|
|
|
|
#### Scripts
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `pnpm dev` | Development with hot reload |
|
|
| `pnpm build` | Production build |
|
|
| `pnpm typecheck` | TypeScript type checking |
|
|
| `pnpm lint:fix` | Lint and auto-fix |
|
|
| `pnpm test` | Run all tests |
|
|
| `pnpm test:watch` | Watch mode |
|
|
| `pnpm test:coverage` | Coverage report |
|
|
| `pnpm check` | Full quality gate (types + lint + test + build) |
|
|
|
|
</details>
|
|
|
|
---
|
|
|
|
## TODO
|
|
|
|
- [ ] Run not only on a local PC but in any headless/console environment (web UI), e.g. VPS, remote server, etc.
|
|
- [ ] 2 modes: current (agent teams), and a new mode: regular subagents (no communication between them)
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for development guidelines. Please read our [Code of Conduct](.github/CODE_OF_CONDUCT.md).
|
|
|
|
## Security
|
|
|
|
IPC handlers validate all inputs with strict path containment checks. File reads are constrained to the project root and `~/.claude`. Sensitive credential paths are blocked. See [SECURITY.md](.github/SECURITY.md) for details.
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|