124 lines
4.8 KiB
Markdown
124 lines
4.8 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>
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases"><img src="https://img.shields.io/github/downloads/777genius/claude_agent_teams_ui/total?style=flat-square&color=green" alt="Downloads" /></a>
|
|
<img src="https://img.shields.io/badge/platform-macOS%20(Apple%20Silicon%20%2B%20Intel)%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform" />
|
|
</p>
|
|
|
|
<br />
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/777genius/claude_agent_teams_ui/releases/latest">
|
|
<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">
|
|
<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">
|
|
<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. Just download, open, and see everything Claude Code did.</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
|
|
|
|
### Direct Download
|
|
|
|
| Platform | Download | Notes |
|
|
|----------|----------|-------|
|
|
| **macOS** (Apple Silicon) | [`.dmg`](https://github.com/777genius/claude_agent_teams_ui/releases/latest) | Download the `arm64` asset. Drag to Applications. On first launch: right-click → Open |
|
|
| **macOS** (Intel) | [`.dmg`](https://github.com/777genius/claude_agent_teams_ui/releases/latest) | Download the `x64` asset. Drag to Applications. On first launch: right-click → Open |
|
|
| **Linux** | [`.AppImage` / `.deb` / `.rpm` / `.pacman`](https://github.com/777genius/claude_agent_teams_ui/releases/latest) | Choose the package format for your distro (portable AppImage or native package manager format). |
|
|
| **Windows** | [`.exe`](https://github.com/777genius/claude_agent_teams_ui/releases/latest) | Standard installer. May trigger SmartScreen — click "More info" → "Run anyway" |
|
|
|
|
The app reads session logs from `~/.claude/` — the data is already on your machine. No setup, no API keys, no login.
|
|
|
|
---
|
|
|
|
## 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.
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines. Please read our [Code of Conduct](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](SECURITY.md) for details.
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|