137 lines
4.9 KiB
Markdown
137 lines
4.9 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>
|
|
|
|
<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
|
|
|
|
No prerequisites — Claude Code can be installed and configured directly from the app.
|
|
|
|
<table align="center">
|
|
<tr>
|
|
<td 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_Apple_Silicon-.dmg-000000?style=for-the-badge&logo=apple&logoColor=white" alt="macOS Apple Silicon" />
|
|
</a>
|
|
<br />
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-x64.dmg">
|
|
<img src="https://img.shields.io/badge/macOS_Intel-.dmg-434343?style=for-the-badge&logo=apple&logoColor=white" alt="macOS Intel" />
|
|
</a>
|
|
</td>
|
|
<td align="center">
|
|
<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_.exe-0078D4?style=for-the-badge&logo=windows&logoColor=white" alt="Windows" />
|
|
</a>
|
|
<br />
|
|
<sub>May trigger SmartScreen — click "More info" → "Run anyway"</sub>
|
|
</td>
|
|
<td align="center">
|
|
<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_.AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Linux AppImage" />
|
|
</a>
|
|
<br />
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-amd64.deb">
|
|
<img src="https://img.shields.io/badge/.deb-E95420?style=flat-square&logo=ubuntu&logoColor=white" alt=".deb" />
|
|
</a>
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-x86_64.rpm">
|
|
<img src="https://img.shields.io/badge/.rpm-294172?style=flat-square&logo=redhat&logoColor=white" alt=".rpm" />
|
|
</a>
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI.pacman">
|
|
<img src="https://img.shields.io/badge/.pacman-1793D1?style=flat-square&logo=archlinux&logoColor=white" alt=".pacman" />
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
---
|
|
|
|
## 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)
|